import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * {@inheritDoc}
 */
protected void addProfilesList(Content profileSummary, Content body) {
    Content h2 = HtmlTree.HEADING(HtmlTag.H2, profileSummary);
    Content profilesDiv = HtmlTree.DIV(h2);
    Content ul = new HtmlTree(HtmlTag.UL);
    String profileName;
    for (int i = 1; i < configuration.profiles.getProfileCount(); i++) {
        profileName = Profile.lookup(i).name;
        // If the profile has valid packages to be documented, add it to the
        // profiles list on overview-summary.html page.
        if (configuration.shouldDocumentProfile(profileName)) {
            Content profileLinkContent = getTargetProfileLink("classFrame",
                    new StringContent(profileName), profileName);
            Content li = HtmlTree.LI(profileLinkContent);
            ul.addContent(li);
        }
    }
    profilesDiv.addContent(ul);
    Content div = HtmlTree.DIV(HtmlStyle.contentContainer, profilesDiv);
    body.addContent(div);
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * {@inheritDoc}
 */
protected void addProfilesList(Profiles profiles, String text,
        String tableSummary, Content body) {
    Content heading = HtmlTree.HEADING(HtmlConstants.PROFILE_HEADING, true,
            profilesLabel);
    Content div = HtmlTree.DIV(HtmlStyle.indexContainer, heading);
    HtmlTree ul = new HtmlTree(HtmlTag.UL);
    ul.setTitle(profilesLabel);
    String profileName;
    for (int i = 1; i < profiles.getProfileCount(); i++) {
        profileName = (Profile.lookup(i)).name;
        // If the profile has valid packages to be documented, add it to the
        // left-frame generated for profile index.
        if (configuration.shouldDocumentProfile(profileName))
            ul.addContent(getProfile(profileName));
    }
    div.addContent(ul);
    body.addContent(div);
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
void initTestClasses() {
    // The following table assumes the existence of specific classes
    // in specific profiles, as defined in the Java SE 8 spec.
    init(Profile.COMPACT1,
            java.lang.String.class);

    init(Profile.COMPACT2,
            javax.xml.XMLConstants.class);

    //init(Profile.COMPACT3,
    //        javax.sql.rowset.Predicate.class,
    //        com.sun.security.auth.PolicyFile.class); // specifically included in 3

    init(Profile.COMPACT3,
            javax.sql.rowset.Predicate.class);

    init(Profile.DEFAULT,
            java.beans.BeanInfo.class);
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
@Test
void testClassesInProfiles() throws Exception {
    for (Profile p: Profile.values()) {
        for (Map.Entry<Profile, List<JavaFileObject>> e: testClasses.entrySet()) {
            for (JavaFileObject fo: e.getValue()) {
                DiagnosticCollector<JavaFileObject> dl =
                        new DiagnosticCollector<JavaFileObject>();
                List<String> opts = (p == Profile.DEFAULT)
                        ? Collections.<String>emptyList()
                        : Arrays.asList("-profile", p.name);
                JavacTask task = (JavacTask) javac.getTask(null, fm, dl, opts, null,
                        Arrays.asList(fo));
                task.analyze();

                List<String> expectDiagCodes = (p.value >= e.getKey().value)
                        ? Collections.<String>emptyList()
                        : Arrays.asList("compiler.err.not.in.profile");

                checkDiags(opts + " " + fo.getName(), dl.getDiagnostics(), expectDiagCodes);
            }
        }
    }
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
void initTestClasses() {
    // The following table assumes the existence of specific classes
    // in specific profiles, as defined in the Java SE 8 spec.
    init(Profile.COMPACT1,
            java.lang.String.class);

    init(Profile.COMPACT2,
            javax.xml.XMLConstants.class);

    init(Profile.COMPACT3,
            javax.sql.rowset.Predicate.class,
            com.sun.security.auth.PolicyFile.class); // specifically included in 3

    init(Profile.DEFAULT,
            java.beans.BeanInfo.class);
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
void initTestClasses() {
    // The following table assumes the existence of specific classes
    // in specific profiles, as defined in the Java SE 8 spec.
    init(Profile.COMPACT1,
            java.lang.String.class);

    init(Profile.COMPACT2,
            javax.xml.XMLConstants.class);

    init(Profile.COMPACT3,
            javax.sql.rowset.Predicate.class,
            com.sun.security.auth.PolicyFile.class); // specifically included in 3

    init(Profile.DEFAULT,
            java.beans.BeanInfo.class,
            javax.management.remote.rmi._RMIServer_Stub.class); // specifically excluded in 3
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Format a single argument of a given diagnostic.
 *
 * @param d diagnostic whose argument is to be formatted
 * @param arg argument to be formatted
 * @param l locale object to be used for i18n
 * @return string representation of the diagnostic argument
 */
protected String formatArgument(JCDiagnostic d, Object arg, Locale l) {
    if (arg instanceof JCDiagnostic) {
        String s = null;
        depth++;
        try {
            s = formatMessage((JCDiagnostic)arg, l);
        }
        finally {
            depth--;
        }
        return s;
    }
    else if (arg instanceof JCExpression) {
        return expr2String((JCExpression)arg);
    }
    else if (arg instanceof Iterable<?>) {
        return formatIterable(d, (Iterable<?>)arg, l);
    }
    else if (arg instanceof Type) {
        return printer.visit((Type)arg, l);
    }
    else if (arg instanceof Symbol) {
        return printer.visit((Symbol)arg, l);
    }
    else if (arg instanceof JavaFileObject) {
        return ((JavaFileObject)arg).getName();
    }
    else if (arg instanceof Profile) {
        return ((Profile)arg).name;
    }
    else if (arg instanceof Formattable) {
        return ((Formattable)arg).toString(l, messages);
    }
    else {
        return String.valueOf(arg);
    }
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Generate a profile package summary page for the left-hand bottom frame. Construct
 * the ProfilePackageFrameWriter object and then uses it generate the file.
 *
 * @param configuration the current configuration of the doclet.
 * @param packageDoc The package for which "profilename-package-frame.html" is to be generated.
 * @param profileValue the value of the profile being documented
 */
public static void generate(ConfigurationImpl configuration,
        PackageDoc packageDoc, int profileValue) {
    ProfilePackageFrameWriter profpackgen;
    try {
        String profileName = Profile.lookup(profileValue).name;
        profpackgen = new ProfilePackageFrameWriter(configuration, packageDoc,
                profileName);
        StringBuilder winTitle = new StringBuilder(profileName);
        String sep = " - ";
        winTitle.append(sep);
        String pkgName = Util.getPackageName(packageDoc);
        winTitle.append(pkgName);
        Content body = profpackgen.getBody(false,
                profpackgen.getWindowTitle(winTitle.toString()));
        Content profName = new StringContent(profileName);
        Content sepContent = new StringContent(sep);
        Content pkgNameContent = new RawHtml(pkgName);
        Content heading = HtmlTree.HEADING(HtmlConstants.TITLE_HEADING, HtmlStyle.bar,
                profpackgen.getTargetProfileLink("classFrame", profName, profileName));
        heading.addContent(sepContent);
        heading.addContent(profpackgen.getTargetProfilePackageLink(packageDoc,
                "classFrame", pkgNameContent, profileName));
        body.addContent(heading);
        HtmlTree div = new HtmlTree(HtmlTag.DIV);
        div.addStyle(HtmlStyle.indexContainer);
        profpackgen.addClassListing(div, profileValue);
        body.addContent(div);
        profpackgen.printHtmlDocument(
                configuration.metakeywords.getMetaKeywords(packageDoc), false, body);
        profpackgen.close();
    } catch (IOException exc) {
        configuration.standardmessage.error(
                "doclet.exception_encountered",
                exc.toString(), DocPaths.PACKAGE_FRAME.getPath());
        throw new DocletAbortException(exc);
    }
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Get the profile keywords.
 *
 * @param profile the profile being documented
 */
public String[] getMetaKeywords(Profile profile) {
    if( configuration.keywords ) {
        String profileName = profile.name;
        return new String[] { profileName + " " + "profile" };
    } else {
        return new String[] {};
    }
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Construct a new ProfilePackageSummaryBuilder.
 *
 * @param context  the build context.
 * @param pkg the profile package being documented.
 * @param profilePackageWriter the doclet specific writer that will output the
 *        result.
 * @param profile the profile being documented.
 */
private ProfilePackageSummaryBuilder(Context context,
        PackageDoc pkg, ProfilePackageSummaryWriter profilePackageWriter,
        Profile profile) {
    super(context);
    this.packageDoc = pkg;
    this.profilePackageWriter = profilePackageWriter;
    this.profileName = profile.name;
    this.profileValue = profile.value;
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
@Override
public ProfilePackageSummaryWriter getProfilePackageSummaryWriter(
		PackageDoc arg0, PackageDoc arg1, PackageDoc arg2, Profile arg3)
		throws Exception {
	// TODO Auto-generated method stub
	return null;
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Returns any extra flags for a class symbol.
 * This information used to be provided using private annotations
 * in the class file in ct.sym; in time, this information will be
 * available from the module system.
 */
long getSupplementaryFlags(ClassSymbol c) {
    if (jrtIndex == null || !jrtIndex.isInJRT(c.classfile) || c.name == names.module_info) {
        return 0;
    }

    if (supplementaryFlags == null) {
        supplementaryFlags = new HashMap<>();
    }

    Long flags = supplementaryFlags.get(c.packge());
    if (flags == null) {
        long newFlags = 0;
        try {
            JRTIndex.CtSym ctSym = jrtIndex.getCtSym(c.packge().flatName());
            Profile minProfile = Profile.DEFAULT;
            if (ctSym.proprietary)
                newFlags |= PROPRIETARY;
            if (ctSym.minProfile != null)
                minProfile = Profile.lookup(ctSym.minProfile);
            if (profile != Profile.DEFAULT && minProfile.value > profile.value) {
                newFlags |= NOT_IN_PROFILE;
            }
        } catch (IOException ignore) {
        }
        supplementaryFlags.put(c.packge(), flags = newFlags);
    }
    return flags;
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
@Test
void testClassesInProfiles() throws Exception {
    for (Profile p: Profile.values()) {
        for (Map.Entry<Profile, List<JavaFileObject>> e: testClasses.entrySet()) {
            for (JavaFileObject fo: e.getValue()) {
                DiagnosticCollector<JavaFileObject> dl =
                        new DiagnosticCollector<JavaFileObject>();
                List<String> opts = (p == Profile.DEFAULT)
                        ? Collections.<String>emptyList()
                        : Arrays.asList("--release", "8", "-profile", p.name);
                JavacTask task = (JavacTask) javac.getTask(null, fm, dl, opts, null,
                        Arrays.asList(fo));
                task.analyze();

                List<String> expectDiagCodes = new ArrayList<>();
                if (fo.getName().equals("TPolicyFile.java")) {
                    expectDiagCodes.add("compiler.warn.has.been.deprecated.for.removal");
                }

                if (p.value < e.getKey().value) {
                    expectDiagCodes.add("compiler.err.not.in.profile");
                }

                checkDiags(opts + " " + fo.getName(), dl.getDiagnostics(), expectDiagCodes);
            }
        }
    }
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
void init(Profile p, Class<?>... classes) {
    List<JavaFileObject> srcs = new ArrayList<JavaFileObject>();
    for (Class<?> c: classes) {
        String name = "T" + c.getSimpleName();
        String src =
                "class T" + name + "{" + "\n" +
                "    Class<?> c = " + c.getName() + ".class;\n" +
                "}";
        srcs.add(new StringJavaFileObject(name + ".java", src));
    }
    testClasses.put(p, srcs);
}
 

import com.sun.tools.javac.jvm.Profile; //导入依赖的package包/类
/**
 * Format a single argument of a given diagnostic.
 *
 * @param d diagnostic whose argument is to be formatted
 * @param arg argument to be formatted
 * @param l locale object to be used for i18n
 * @return string representation of the diagnostic argument
 */
protected String formatArgument(JCDiagnostic d, Object arg, Locale l) {
    if (arg instanceof JCDiagnostic) {
        String s = null;
        depth++;
        try {
            s = formatMessage((JCDiagnostic)arg, l);
        }
        finally {
            depth--;
        }
        return s;
    }
    else if (arg instanceof JCExpression) {
        return expr2String((JCExpression)arg);
    }
    else if (arg instanceof Iterable<?> && !(arg instanceof Path)) {
        return formatIterable(d, (Iterable<?>)arg, l);
    }
    else if (arg instanceof Type) {
        return printer.visit((Type)arg, l);
    }
    else if (arg instanceof Symbol) {
        return printer.visit((Symbol)arg, l);
    }
    else if (arg instanceof JavaFileObject) {
        return ((JavaFileObject)arg).getName();
    }
    else if (arg instanceof Profile) {
        return ((Profile)arg).name;
    }
    else if (arg instanceof Formattable) {
        return ((Formattable)arg).toString(l, messages);
    }
    else {
        return String.valueOf(arg);
    }
}