@EmbeddingProvider.Registration(

        mimeType="text/html",

        targetMimeType="text/css"

)

            int slen = snapshot.getText().length();

            LOG.fine(String.format("CssEmbeddingProvider.create(snapshot): mimetype: %s, size: %s", snapshot.getMimeType(), slen)); //NOI18N

            if(slen > MAX_SNAPSHOT_SIZE) {

                LOG.fine(String.format("Size %s > maximum (%s) => providing no css embedding", slen, MAX_SNAPSHOT_SIZE)); //NOI18N

                return Collections.<Embedding>emptyList();

            }

  <change id="EmbeddingProvider.Registration">

      <api name="ParsingAPI"/>

      <summary>Added <code>EmbeddingProvider.Registration</code> annotation to register <code>EmbeddingProvider</code>s.</summary>

      <version major="1" minor="57"/>

      <date day="14" month="9" year="2012"/>

      <author login="tzezula"/>

      <compatibility source="compatible" binary="compatible" semantic="compatible" deletion="no" addition="yes" modification="no"/>

      <description>

          <p>

               Added <code>EmbeddingProvider.Registration</code> annotation to register <code>EmbeddingProvider</code>s.

               The registration provides a mime type of a generated embedding which allows the infrastructure to correctly

               handle embedded indexes.

          </p>

      </description>

      <class package="org.netbeans.modules.parsing.spi" name="EmbeddingProvider"/>

      <issue number="218148"/>

  </change>

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2012 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2012 Sun Microsystems, Inc.

 */

package org.netbeans.modules.parsing.impl;

import java.util.Collection;

import java.util.Collections;

import java.util.Map;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.modules.parsing.api.Snapshot;

import org.netbeans.modules.parsing.spi.EmbeddingProvider;

import org.netbeans.modules.parsing.spi.SchedulerTask;

import org.netbeans.modules.parsing.spi.TaskFactory;

import org.openide.util.Parameters;

/**

 *

 * @author Tomas Zezula

 */

public class EmbeddingProviderFactory extends TaskFactory {

    public static final String ATTR_TARGET_MIME_TYPE = "targetMimeType";   //NOI18N

    public static final String ATTR_PROVIDER = "provider";                 //NOI18N

    private final Map<String,Object> params;

    private final String targetMimeType;

    private EmbeddingProviderFactory(@NonNull final Map<String,Object> params) {

        Parameters.notNull("definition", params);   //NOI18N

        this.params = params;

        this.targetMimeType = (String) params.get(ATTR_TARGET_MIME_TYPE);

        if (this.targetMimeType == null) {

            throw new IllegalArgumentException(

                String.format(

                    "The definition file has no %s attribute.", //NOI18N

                    ATTR_TARGET_MIME_TYPE));

        }

    }

    public String getTargetMimeType() {

        return this.targetMimeType;

    }

    @NonNull

    @Override

    public Collection<? extends SchedulerTask> create (@NonNull final Snapshot snapshot) {

        final Object delegate = params.get(ATTR_PROVIDER);

        return (delegate instanceof EmbeddingProvider) ?

                Collections.singleton((EmbeddingProvider)delegate) :

                Collections.<EmbeddingProvider>emptySet();

    }

    public static TaskFactory create(@NonNull final Map<String,Object> params) {

        return new EmbeddingProviderFactory(params);

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2012 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2012 Sun Microsystems, Inc.

 */

package org.netbeans.modules.parsing.impl;

import java.util.Collections;

import java.util.Set;

import javax.annotation.processing.Processor;

import javax.annotation.processing.RoundEnvironment;

import javax.annotation.processing.SupportedSourceVersion;

import javax.lang.model.SourceVersion;

import javax.lang.model.element.Element;

import javax.lang.model.element.TypeElement;

import org.netbeans.modules.parsing.spi.EmbeddingProvider;

import org.netbeans.modules.parsing.spi.TaskFactory;

import org.openide.filesystems.annotations.LayerGeneratingProcessor;

import org.openide.filesystems.annotations.LayerGenerationException;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=Processor.class)

@SupportedSourceVersion(SourceVersion.RELEASE_6)

public class EmbeddingProviderRegistrationProcessor extends LayerGeneratingProcessor {

    @Override

    public Set<String> getSupportedAnnotationTypes() {

        return Collections.singleton(EmbeddingProvider.Registration.class.getCanonicalName());

    }

    @Override

    protected boolean handleProcess(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) throws LayerGenerationException {

        for (Element e :  roundEnv.getElementsAnnotatedWith(EmbeddingProvider.Registration.class)) {

            if (!e.getKind().isClass()) {

                throw new LayerGenerationException("Annotated Element has to be a class.", e);  //NOI18N

            }

            final EmbeddingProvider.Registration reg = e.getAnnotation(EmbeddingProvider.Registration.class);

            String mimeType = reg.mimeType();

            if (mimeType == null) {

                throw new LayerGenerationException("Mime type has to be given.", e);  //NOI18N

            } else if (!mimeType.isEmpty()) {

                mimeType =  '/' + mimeType; //NOI18N

            }

            String targetMimeType = reg.targetMimeType();

            if (targetMimeType == null || targetMimeType.isEmpty()) {

                throw new LayerGenerationException("Target mime type has to be given.", e);  //NOI18N

            }

            layer(e).

                instanceFile("Editors" + mimeType, null, null).    //NOI18N

                stringvalue("instanceOf", TaskFactory.class.getName()).         ///NOI18N

                methodvalue("instanceCreate", EmbeddingProviderFactory.class.getName(), "create").         //NOI18N

                stringvalue(EmbeddingProviderFactory.ATTR_TARGET_MIME_TYPE, targetMimeType).

                instanceAttribute(EmbeddingProviderFactory.ATTR_PROVIDER, EmbeddingProvider.class).

                write();

        }

        return true;

    }

}

    @NonNull

    private static Collection<? extends IndexerCache.IndexerInfo<EmbeddingIndexerFactory>> collectEmbeddingIndexers(

            @NonNull final String topMimeType){

        final Collection<IndexerCache.IndexerInfo<EmbeddingIndexerFactory>> result = new ArrayDeque<IndexerInfo<EmbeddingIndexerFactory>>();

        collectEmbeddingIndexers(topMimeType, result);

        return result;

    }

    private static void collectEmbeddingIndexers(

            @NonNull final String mimeType,

            @NonNull final Collection<? super IndexerCache.IndexerInfo<EmbeddingIndexerFactory>> collector) {

        collector.addAll(IndexerCache.getEifCache().getIndexersFor(mimeType, true));

        for (EmbeddingProviderFactory epf : MimeLookup.getLookup(MimePath.get(mimeType)).lookupAll(EmbeddingProviderFactory.class)) {

            collectEmbeddingIndexers(epf.getTargetMimeType(), collector);

        }

    }

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

import org.netbeans.modules.parsing.spi.indexing.support.QuerySupport;

    /**

     * Registration of the {@link EmbeddingProvider}.

     * Creates a mime lookup registration of the {@link TaskFactory} for

     * annotated {@link EmbeddingProvider}. It also provides the target

     * mime type of the created embedding which allows the {@link QuerySupport}

     * to correctly mark dirty embedded indexers.

     *

     * @since 1.57

     */

    @Retention(RetentionPolicy.SOURCE)

    @Target(ElementType.TYPE)

    public @interface Registration {

        /**

         * Mime type to which should be the given {@link EmbeddingProvider} registered.

         */

         public String mimeType();

        /**

         * Mime type of the embedding created by the registered {@link EmbeddingProvider}

         */

        String targetMimeType();

    }

import org.netbeans.modules.parsing.impl.EmbeddingProviderFactory;

        final Map<String,Object> attrMap = new HashMap<String,Object>();

        attrMap.put(EmbeddingProviderFactory.ATTR_TARGET_MIME_TYPE, MIME_INNER);

        attrMap.put(EmbeddingProviderFactory.ATTR_PROVIDER, new TopToInnerEmbProvider());

        assertEquals(1, srcCp.getRoots().length);

        assertEquals(srcRoot, srcCp.getRoots()[0]);

                } else if (text.charAt(i) == 'C') {

                    res.setMode(InnerResult.C);

                    break;

        static synchronized  void setRoot(@NonNull final FileObject r) {

            cp = null;

            root = r;

        }