Search in sources :

Example 1 with TopExtensionDependency

use of io.quarkus.devtools.project.state.TopExtensionDependency in project quarkus by quarkusio.

the class InfoCommandHandler method resolveProjectState.

protected static ProjectState resolveProjectState(ApplicationModel appModel, ExtensionCatalog currentCatalog) {
    final ProjectState.Builder projectBuilder = ProjectState.builder();
    final Collection<ArtifactCoords> importedPlatformBoms = appModel.getPlatforms().getImportedPlatformBoms();
    if (importedPlatformBoms.isEmpty()) {
        return projectBuilder.build();
    }
    final Map<String, ExtensionProvider.Builder> extProviderBuilders = new LinkedHashMap<>(importedPlatformBoms.size());
    importedPlatformBoms.forEach(bom -> {
        projectBuilder.addPlatformBom(bom);
        extProviderBuilders.put(ExtensionProvider.key(bom, true), ExtensionProvider.builder().setArtifact(bom).setPlatform(true));
    });
    final Map<WorkspaceModuleId, ModuleState.Builder> projectModuleBuilders = new HashMap<>();
    final Map<ArtifactKey, List<ModuleState.Builder>> directModuleDeps = new HashMap<>();
    final WorkspaceModule appModule = appModel.getAppArtifact().getWorkspaceModule();
    if (appModule != null) {
        final ModuleState.Builder module = ModuleState.builder().setWorkspaceModule(appModule).setMainModule(true);
        projectModuleBuilders.put(appModule.getId(), module);
        appModule.getDirectDependencies().forEach(d -> directModuleDeps.computeIfAbsent(d.getKey(), dk -> new ArrayList<>()).add(module));
        for (Dependency constraint : appModule.getDirectDependencyConstraints()) {
            if (extProviderBuilders.containsKey(constraint.toCompactCoords())) {
                module.addPlatformBom(constraint);
            }
        }
    }
    for (ResolvedDependency dep : appModel.getDependencies()) {
        if (dep.getWorkspaceModule() != null) {
            projectModuleBuilders.computeIfAbsent(dep.getWorkspaceModule().getId(), k -> {
                final ModuleState.Builder module = ModuleState.builder().setWorkspaceModule(dep.getWorkspaceModule());
                dep.getWorkspaceModule().getDirectDependencies().forEach(d -> directModuleDeps.computeIfAbsent(d.getKey(), dk -> new ArrayList<>()).add(module));
                return module;
            });
        }
    }
    final Map<ArtifactKey, TopExtensionDependency.Builder> directExtDeps = new HashMap<>();
    for (ResolvedDependency dep : appModel.getDependencies()) {
        if (dep.isFlagSet(DependencyFlags.TOP_LEVEL_RUNTIME_EXTENSION_ARTIFACT)) {
            directExtDeps.put(dep.getKey(), TopExtensionDependency.builder().setResolvedDependency(dep).setTransitive(!directModuleDeps.containsKey(dep.getKey())));
        } else if (dep.isRuntimeExtensionArtifact() && directModuleDeps.containsKey(dep.getKey())) {
            directExtDeps.put(dep.getKey(), TopExtensionDependency.builder().setResolvedDependency(dep));
        }
    }
    if (directExtDeps.isEmpty()) {
        return projectBuilder.build();
    }
    currentCatalog.getExtensions().forEach(e -> {
        final ArtifactKey key = e.getArtifact().getKey();
        final TopExtensionDependency.Builder dep = directExtDeps.get(key);
        if (dep != null) {
            dep.setCatalogMetadata(e);
        }
    });
    for (TopExtensionDependency.Builder extBuilder : directExtDeps.values()) {
        final List<ModuleState.Builder> modules = directModuleDeps.getOrDefault(extBuilder.getKey(), Collections.emptyList());
        final TopExtensionDependency dep = extBuilder.setTransitive(modules.isEmpty()).build();
        projectBuilder.addExtensionDependency(dep);
        for (ModuleState.Builder module : modules) {
            module.addExtensionDependency(dep);
        }
        final ExtensionProvider.Builder provider = extProviderBuilders.computeIfAbsent(dep.getProviderKey(), k -> ExtensionProvider.builder().setOrigin(dep.getOrigin()));
        provider.addExtension(dep);
    }
    for (ExtensionProvider.Builder builder : extProviderBuilders.values()) {
        projectBuilder.addExtensionProvider(builder.build());
    }
    for (ModuleState.Builder builder : projectModuleBuilders.values()) {
        projectBuilder.addModule(builder.build());
    }
    return projectBuilder.build();
}
Also used : ArtifactCoords(io.quarkus.maven.dependency.ArtifactCoords) ArtifactKey(io.quarkus.maven.dependency.ArtifactKey) HashMap(java.util.HashMap) LinkedHashMap(java.util.LinkedHashMap) ResolvedDependency(io.quarkus.maven.dependency.ResolvedDependency) ExtensionProvider(io.quarkus.devtools.project.state.ExtensionProvider) LinkedHashMap(java.util.LinkedHashMap) ArrayList(java.util.ArrayList) List(java.util.List) WorkspaceModuleId(io.quarkus.bootstrap.workspace.WorkspaceModuleId) Dependency(io.quarkus.maven.dependency.Dependency) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency) ResolvedDependency(io.quarkus.maven.dependency.ResolvedDependency) ModuleState(io.quarkus.devtools.project.state.ModuleState) ProjectState(io.quarkus.devtools.project.state.ProjectState) WorkspaceModule(io.quarkus.bootstrap.workspace.WorkspaceModule) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency)

Example 2 with TopExtensionDependency

use of io.quarkus.devtools.project.state.TopExtensionDependency in project quarkus by quarkusio.

the class UpdateCommandHandler method resolveRecommendedState.

private static ProjectState resolveRecommendedState(ProjectState currentState, ExtensionCatalog latestCatalog, MessageWriter log) {
    if (currentState.getPlatformBoms().isEmpty()) {
        return currentState;
    }
    if (currentState.getExtensions().isEmpty()) {
        return currentState;
    }
    final ExtensionMap extensionInfo = new ExtensionMap();
    for (TopExtensionDependency dep : currentState.getExtensions()) {
        extensionInfo.add(new ExtensionInfo(dep));
    }
    for (Extension e : latestCatalog.getExtensions()) {
        final ExtensionInfo candidate = extensionInfo.get(e.getArtifact().getKey());
        if (candidate != null && candidate.latestMetadata == null) {
            // if the latestMetadata has already been initialized, it's already the preferred one
            // that could happen if an artifact has relocated
            candidate.latestMetadata = e;
        }
    }
    final List<ExtensionInfo> unknownExtensions = new ArrayList<>(0);
    final List<Extension> updateCandidates = new ArrayList<>(extensionInfo.size());
    final Map<String, ExtensionMap> updateCandidatesByOrigin = new HashMap<>();
    for (ExtensionInfo i : extensionInfo.values()) {
        if (i.latestMetadata == null) {
            unknownExtensions.add(i);
        } else {
            updateCandidates.add(i.latestMetadata);
            for (ExtensionOrigin o : i.latestMetadata.getOrigins()) {
                updateCandidatesByOrigin.computeIfAbsent(o.getId(), k -> new ExtensionMap()).add(i);
            }
        }
    }
    if (extensionInfo.isEmpty()) {
        return currentState;
    }
    if (!unknownExtensions.isEmpty()) {
        log.warn("The configured Quarkus registries did not provide any compatibility information for the following extensions in the context of the currently recommended Quarkus platforms:");
        unknownExtensions.forEach(e -> log.warn(" " + e.currentDep.getArtifact().toCompactCoords()));
    }
    final List<ExtensionCatalog> recommendedOrigins;
    try {
        recommendedOrigins = getRecommendedOrigins(latestCatalog, updateCandidates);
    } catch (QuarkusCommandException e) {
        log.info("Failed to find a compatible configuration update for the project");
        return currentState;
    }
    int collectedUpdates = 0;
    for (ExtensionCatalog recommendedOrigin : recommendedOrigins) {
        final ExtensionMap candidates = updateCandidatesByOrigin.get(recommendedOrigin.getId());
        for (Extension e : recommendedOrigin.getExtensions()) {
            final ExtensionInfo info = candidates.get(e.getArtifact().getKey());
            if (info != null && info.recommendedMetadata == null) {
                info.setRecommendedMetadata(e);
                if (++collectedUpdates == updateCandidates.size()) {
                    break;
                }
            }
        }
    }
    final ProjectState.Builder stateBuilder = ProjectState.builder();
    for (ExtensionCatalog c : recommendedOrigins) {
        if (c.isPlatform()) {
            stateBuilder.addPlatformBom(c.getBom());
        }
    }
    final Map<String, ExtensionProvider.Builder> extProviders = new LinkedHashMap<>(recommendedOrigins.size());
    for (ExtensionInfo info : extensionInfo.values()) {
        final TopExtensionDependency ext = info.getRecommendedDependency();
        stateBuilder.addExtensionDependency(ext);
        extProviders.computeIfAbsent(ext.getProviderKey(), k -> ExtensionProvider.builder().setOrigin(ext.getOrigin())).addExtension(ext);
    }
    extProviders.values().forEach(b -> stateBuilder.addExtensionProvider(b.build()));
    for (ModuleState module : currentState.getModules()) {
        final ModuleState.Builder moduleBuilder = ModuleState.builder().setMainModule(module.isMain()).setWorkspaceModule(module.getWorkspaceModule());
        for (TopExtensionDependency dep : module.getExtensions()) {
            final TopExtensionDependency recommendedDep = extensionInfo.get(dep.getKey()).getRecommendedDependency();
            moduleBuilder.addExtensionDependency(recommendedDep);
            final ExtensionOrigin origin = recommendedDep.getOrigin();
            if (origin != null && origin.isPlatform()) {
                moduleBuilder.addPlatformBom(origin.getBom());
            }
        }
        stateBuilder.addModule(moduleBuilder.build());
    }
    return stateBuilder.build();
}
Also used : OriginPreference(io.quarkus.registry.catalog.selection.OriginPreference) ExtensionOrigins(io.quarkus.registry.catalog.selection.ExtensionOrigins) HashMap(java.util.HashMap) ArrayList(java.util.ArrayList) LinkedHashMap(java.util.LinkedHashMap) QuarkusCommandInvocation(io.quarkus.devtools.commands.data.QuarkusCommandInvocation) ArtifactKey(io.quarkus.maven.dependency.ArtifactKey) ArtifactCoords(io.quarkus.maven.dependency.ArtifactCoords) Map(java.util.Map) QuarkusCommandOutcome(io.quarkus.devtools.commands.data.QuarkusCommandOutcome) ExtensionCatalog(io.quarkus.registry.catalog.ExtensionCatalog) ModuleState(io.quarkus.devtools.project.state.ModuleState) PlatformInfo(io.quarkus.devtools.commands.handlers.InfoCommandHandler.PlatformInfo) ExtensionProvider(io.quarkus.devtools.project.state.ExtensionProvider) Collection(java.util.Collection) Collectors(java.util.stream.Collectors) OriginSelector(io.quarkus.registry.catalog.selection.OriginSelector) ExtensionOrigin(io.quarkus.registry.catalog.ExtensionOrigin) List(java.util.List) ApplicationModel(io.quarkus.bootstrap.model.ApplicationModel) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency) QuarkusCommandException(io.quarkus.devtools.commands.data.QuarkusCommandException) MessageWriter(io.quarkus.devtools.messagewriter.MessageWriter) Extension(io.quarkus.registry.catalog.Extension) OriginCombination(io.quarkus.registry.catalog.selection.OriginCombination) Collections(java.util.Collections) ProjectState(io.quarkus.devtools.project.state.ProjectState) HashMap(java.util.HashMap) LinkedHashMap(java.util.LinkedHashMap) ArrayList(java.util.ArrayList) ExtensionCatalog(io.quarkus.registry.catalog.ExtensionCatalog) ModuleState(io.quarkus.devtools.project.state.ModuleState) QuarkusCommandException(io.quarkus.devtools.commands.data.QuarkusCommandException) LinkedHashMap(java.util.LinkedHashMap) Extension(io.quarkus.registry.catalog.Extension) ProjectState(io.quarkus.devtools.project.state.ProjectState) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency) ExtensionOrigin(io.quarkus.registry.catalog.ExtensionOrigin)

Example 3 with TopExtensionDependency

use of io.quarkus.devtools.project.state.TopExtensionDependency in project quarkus by quarkusio.

the class InfoCommandHandler method logState.

// TODO: instead of returning a boolean, the info about available
// recommendations should be reflected in ProjectState
protected static boolean logState(ProjectState projectState, boolean perModule, boolean rectify, MessageWriter log) {
    boolean recommendationsAvailable = false;
    final Map<ArtifactKey, PlatformInfo> providerInfo = new LinkedHashMap<>();
    for (ArtifactCoords bom : projectState.getPlatformBoms()) {
        providerInfo.computeIfAbsent(bom.getKey(), k -> new PlatformInfo()).imported = bom;
    }
    for (TopExtensionDependency dep : projectState.getExtensions()) {
        final ExtensionOrigin origin = dep.getOrigin();
        if (origin != null && origin.isPlatform()) {
            providerInfo.computeIfAbsent(origin.getBom().getKey(), k -> new PlatformInfo()).recommended = origin.getBom();
        }
    }
    if (providerInfo.isEmpty()) {
        log.info("No Quarkus platform BOMs found");
    } else {
        log.info("Quarkus platform BOMs:");
        boolean recommendExtraImports = false;
        for (PlatformInfo platform : providerInfo.values()) {
            if (platform.imported == null) {
                recommendExtraImports = true;
                continue;
            }
            final StringBuilder sb = new StringBuilder();
            if (platform.recommended == null) {
                if (rectify) {
                    sb.append(String.format(UpdateCommandHandler.PLATFORM_RECTIFY_FORMAT, UpdateCommandHandler.REMOVE, platform.imported.toCompactCoords()));
                    recommendationsAvailable = true;
                } else {
                    sb.append("  ");
                    sb.append(platform.imported.toCompactCoords());
                    if (!projectState.getExtensions().isEmpty()) {
                        // The extension check is for modules that are aggregating modules (e.g. parent POMs)
                        // that import common BOMs. It's however not how it should be done.
                        sb.append(" | unnecessary");
                        recommendationsAvailable = true;
                    }
                }
            } else if (platform.isVersionUpdateRecommended()) {
                if (rectify) {
                    sb.append(String.format(UpdateCommandHandler.PLATFORM_RECTIFY_FORMAT, UpdateCommandHandler.UPDATE, platform.imported.toCompactCoords()));
                    sb.append(platform.imported.toCompactCoords()).append(" -> ").append(platform.getRecommendedVersion());
                } else {
                    sb.append("  ");
                    sb.append(platform.imported.toCompactCoords()).append(" | misaligned");
                }
                recommendationsAvailable = true;
            } else {
                if (rectify) {
                    sb.append(String.format(UpdateCommandHandler.PLATFORM_RECTIFY_FORMAT, "", platform.imported.toCompactCoords()));
                } else {
                    sb.append("  ").append(platform.imported.toCompactCoords());
                }
            }
            log.info(sb.toString());
        }
        if (rectify && recommendExtraImports) {
            for (PlatformInfo platform : providerInfo.values()) {
                if (platform.imported == null) {
                    log.info(String.format(UpdateCommandHandler.PLATFORM_RECTIFY_FORMAT, UpdateCommandHandler.ADD, platform.recommended.toCompactCoords()));
                }
            }
            recommendationsAvailable = true;
        }
    }
    if (projectState.getExtensions().isEmpty()) {
        log.info("");
        log.info("No Quarkus extensions found among the project dependencies");
        return recommendationsAvailable;
    }
    log.info("");
    if (perModule) {
        final ModuleState mainModule = projectState.getMainModule();
        final Path baseDir = mainModule.getModuleDir();
        recommendationsAvailable |= logModuleInfo(projectState, mainModule, baseDir, log, rectify);
        for (ModuleState module : projectState.getModules()) {
            if (!module.isMain()) {
                recommendationsAvailable |= logModuleInfo(projectState, module, baseDir, log, rectify);
            }
        }
    } else {
        for (ExtensionProvider provider : projectState.getExtensionProviders()) {
            if (provider.isPlatform()) {
                recommendationsAvailable = logProvidedExtensions(provider, rectify, log, recommendationsAvailable);
            }
        }
        for (ExtensionProvider provider : projectState.getExtensionProviders()) {
            if (!provider.isPlatform()) {
                recommendationsAvailable = logProvidedExtensions(provider, rectify, log, recommendationsAvailable);
            }
        }
    }
    return recommendationsAvailable;
}
Also used : Path(java.nio.file.Path) ArtifactCoords(io.quarkus.maven.dependency.ArtifactCoords) ArtifactKey(io.quarkus.maven.dependency.ArtifactKey) ExtensionProvider(io.quarkus.devtools.project.state.ExtensionProvider) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency) ModuleState(io.quarkus.devtools.project.state.ModuleState) LinkedHashMap(java.util.LinkedHashMap) ExtensionOrigin(io.quarkus.registry.catalog.ExtensionOrigin)

Example 4 with TopExtensionDependency

use of io.quarkus.devtools.project.state.TopExtensionDependency in project quarkus by quarkusio.

the class InfoCommandHandler method logProvidedExtensions.

private static boolean logProvidedExtensions(ExtensionProvider provider, boolean rectify, MessageWriter log, boolean recommendationsAvailable) {
    if (provider.getExtensions().isEmpty()) {
        return recommendationsAvailable;
    }
    log.info("Extensions from " + provider.getKey() + ":");
    final StringBuilder sb = new StringBuilder();
    for (TopExtensionDependency dep : provider.getExtensions()) {
        sb.setLength(0);
        recommendationsAvailable = logExtensionInfo(dep, rectify, sb, recommendationsAvailable);
        log.info(sb.toString());
    }
    log.info("");
    return recommendationsAvailable;
}
Also used : TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency)

Example 5 with TopExtensionDependency

use of io.quarkus.devtools.project.state.TopExtensionDependency in project quarkus by quarkusio.

the class InfoCommandHandler method logModuleInfo.

private static boolean logModuleInfo(ProjectState project, ModuleState module, Path baseDir, MessageWriter log, boolean rectify) {
    if (module.getExtensions().isEmpty() && module.getPlatformBoms().isEmpty() && !module.isMain()) {
        return false;
    }
    boolean recommendationsAvailable = false;
    final StringBuilder sb = new StringBuilder();
    if (module.isMain()) {
        sb.append("Main application module ");
    } else {
        sb.append("Module ");
    }
    sb.append(module.getId().getGroupId()).append(':').append(module.getId().getArtifactId()).append(':');
    log.info(sb.toString());
    final Iterator<Path> i = module.getWorkspaceModule().getBuildFiles().iterator();
    if (i.hasNext()) {
        sb.setLength(0);
        sb.append("  Build file: ");
        sb.append(baseDir.relativize(i.next()));
        while (i.hasNext()) {
            sb.append(", ").append(baseDir.relativize(i.next()));
        }
        log.info(sb.toString());
    }
    if (!module.getPlatformBoms().isEmpty()) {
        log.info("  Platform BOMs:");
        for (ArtifactCoords bom : module.getPlatformBoms()) {
            log.info("    " + bom.toCompactCoords());
        }
    }
    if (!module.getExtensions().isEmpty()) {
        final Map<String, List<TopExtensionDependency>> extDepsByProvider = new LinkedHashMap<>();
        for (TopExtensionDependency dep : module.getExtensions()) {
            extDepsByProvider.computeIfAbsent(dep.getProviderKey(), k -> new ArrayList<>()).add(dep);
        }
        for (ExtensionProvider provider : project.getExtensionProviders()) {
            if (!provider.isPlatform()) {
                continue;
            }
            final List<TopExtensionDependency> extList = extDepsByProvider.getOrDefault(provider.getKey(), Collections.emptyList());
            if (!extList.isEmpty()) {
                log.info("  Extensions from " + provider.getKey() + ":");
                for (TopExtensionDependency dep : extList) {
                    sb.setLength(0);
                    sb.append("  ");
                    recommendationsAvailable = logExtensionInfo(dep, rectify, sb, recommendationsAvailable);
                    log.info(sb.toString());
                }
                log.info("");
            }
        }
        for (ExtensionProvider provider : project.getExtensionProviders()) {
            if (provider.isPlatform()) {
                continue;
            }
            final List<TopExtensionDependency> extList = extDepsByProvider.getOrDefault(provider.getKey(), Collections.emptyList());
            if (!extList.isEmpty()) {
                log.info("  Extensions from " + provider.getKey() + ":");
                for (TopExtensionDependency dep : extList) {
                    sb.setLength(0);
                    sb.append("  ");
                    recommendationsAvailable = logExtensionInfo(dep, rectify, sb, recommendationsAvailable);
                    log.info(sb.toString());
                }
                log.info("");
            }
        }
    }
    return recommendationsAvailable;
}
Also used : Path(java.nio.file.Path) HashMap(java.util.HashMap) ArrayList(java.util.ArrayList) LinkedHashMap(java.util.LinkedHashMap) QuarkusCommandInvocation(io.quarkus.devtools.commands.data.QuarkusCommandInvocation) DependencyFlags(io.quarkus.maven.dependency.DependencyFlags) ArtifactKey(io.quarkus.maven.dependency.ArtifactKey) ArtifactCoords(io.quarkus.maven.dependency.ArtifactCoords) Map(java.util.Map) Dependency(io.quarkus.maven.dependency.Dependency) QuarkusCommandOutcome(io.quarkus.devtools.commands.data.QuarkusCommandOutcome) WorkspaceModule(io.quarkus.bootstrap.workspace.WorkspaceModule) Path(java.nio.file.Path) ExtensionCatalog(io.quarkus.registry.catalog.ExtensionCatalog) ModuleState(io.quarkus.devtools.project.state.ModuleState) Iterator(java.util.Iterator) ExtensionProvider(io.quarkus.devtools.project.state.ExtensionProvider) Collection(java.util.Collection) WorkspaceModuleId(io.quarkus.bootstrap.workspace.WorkspaceModuleId) ExtensionOrigin(io.quarkus.registry.catalog.ExtensionOrigin) List(java.util.List) ApplicationModel(io.quarkus.bootstrap.model.ApplicationModel) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency) QuarkusCommandException(io.quarkus.devtools.commands.data.QuarkusCommandException) ResolvedDependency(io.quarkus.maven.dependency.ResolvedDependency) MessageWriter(io.quarkus.devtools.messagewriter.MessageWriter) Collections(java.util.Collections) ProjectState(io.quarkus.devtools.project.state.ProjectState) ArtifactCoords(io.quarkus.maven.dependency.ArtifactCoords) ArrayList(java.util.ArrayList) ExtensionProvider(io.quarkus.devtools.project.state.ExtensionProvider) LinkedHashMap(java.util.LinkedHashMap) ArrayList(java.util.ArrayList) List(java.util.List) TopExtensionDependency(io.quarkus.devtools.project.state.TopExtensionDependency)

Aggregations

TopExtensionDependency (io.quarkus.devtools.project.state.TopExtensionDependency)6 ExtensionProvider (io.quarkus.devtools.project.state.ExtensionProvider)5 ModuleState (io.quarkus.devtools.project.state.ModuleState)5 ArtifactCoords (io.quarkus.maven.dependency.ArtifactCoords)5 ArtifactKey (io.quarkus.maven.dependency.ArtifactKey)5 LinkedHashMap (java.util.LinkedHashMap)5 ProjectState (io.quarkus.devtools.project.state.ProjectState)4 ExtensionOrigin (io.quarkus.registry.catalog.ExtensionOrigin)4 ArrayList (java.util.ArrayList)4 HashMap (java.util.HashMap)4 List (java.util.List)4 ApplicationModel (io.quarkus.bootstrap.model.ApplicationModel)3 QuarkusCommandException (io.quarkus.devtools.commands.data.QuarkusCommandException)3 QuarkusCommandInvocation (io.quarkus.devtools.commands.data.QuarkusCommandInvocation)3 QuarkusCommandOutcome (io.quarkus.devtools.commands.data.QuarkusCommandOutcome)3 MessageWriter (io.quarkus.devtools.messagewriter.MessageWriter)3 ExtensionCatalog (io.quarkus.registry.catalog.ExtensionCatalog)3 Collection (java.util.Collection)3 Collections (java.util.Collections)3 Map (java.util.Map)3