import org.netbeans.api.server.VMArguments;

        if (!GlassfishModule.PROFILE_MODE.equals(ip.get(GlassfishModule.JVM_MODE))) {

            for (VMArguments args : VMArguments.getVMArguments()) {

                for (String singleArg : args.getArguments()) {

                    argumentBuf.append(' ').append(singleArg);

                }

            }

        }

                    <code-name-base>org.netbeans.modules.server</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>0-1</release-version>

                        <specification-version>1.18</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

import org.netbeans.api.server.VMArguments;

        if (startServer.getMode() != JBStartServer.MODE.PROFILE) {

            for (VMArguments args : VMArguments.getVMArguments()) {

                for (String singleArg : args.getArguments()) {

                    javaOptsBuilder.append(' ').append(singleArg);

                }

            }

        }

                    <code-name-base>org.netbeans.modules.server</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>0-1</release-version>

                        <specification-version>1.18</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

import org.netbeans.api.server.VMArguments;

            for (VMArguments args : VMArguments.getVMArguments()) {

                for (String singleArg : args.getArguments()) {

                    javaOptsBuilder.append(' ').append(singleArg);

                }

            }

        <change id="vm.arguments">

            <api name="common_server_api"/>

            <summary>SPI to allow passing additional arguments to server VM</summary>

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

            <date day="22" month="12" year="2011"/>

            <author login="phejl"/>

            <compatibility addition="yes"/>

            <description>

                This API/SPI allow third party plugins (such as JRebel) to

                register providers of VM arguments. The server plugin may

                optionaly query such arguments and pass them to server VM.

            </description>

            <class package="org.netbeans.api.server" name="VMArguments"/>

            <class package="org.netbeans.spi.server" name="VMArgumentsProvider"/>

            <issue number="206196"/>

        </change>

      <api group="layer" name="VMArgumentsProvider" type="export" category="devel">

            By registering providers to <code>Servers/VMArgumentsProviders</code> you

            can register your additional VM arguments provider.

      </api>

                    <code-name-base>org.netbeans.api.annotations.common</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>1</release-version>

                        <specification-version>1.13</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

                    <code-name-base>org.netbeans.core.ide</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>1</release-version>

                        <specification-version>1.15</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

/*

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

 *

 * Copyright 2011 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 2011 Sun Microsystems, Inc.

 */

package org.netbeans.api.server;

import java.util.ArrayList;

import java.util.List;

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

import org.netbeans.modules.server.annotations.VMArgumentsRegistrationProcessor;

import org.netbeans.spi.server.VMArgumentsProvider;

import org.openide.util.Lookup;

import org.openide.util.lookup.Lookups;

/**

 * The API class allowing clients, typically server plugins, to query additional

 * groups of arguments it may pass to VM.

 *

 * @author Petr Hejl

 * @since 1.18

 * @see VMArgumentsProvider

 */

public final class VMArguments {

    private final String description;

    private final List<String> arguments;

    private VMArguments(String description, List<String> arguments) {

        this.description = description;

        this.arguments = arguments;

    }

    /**

     * Returns the groups of arguments provided by all registered

     * {@link VMArgumentsProvider}.

     *

     * @return the groups of arguments provided by all registered

     *             {@link VMArgumentsProvider}

     */

    @NonNull

    public static List<VMArguments> getVMArguments() {

        Lookup lkp = Lookups.forPath(VMArgumentsRegistrationProcessor.PATH);

        List<VMArguments> res = new ArrayList<VMArguments>();

        for (VMArgumentsProvider prov : lkp.lookupAll(VMArgumentsProvider.class)) {

            res.add(new VMArguments(prov.getDescription(), prov.getArguments()));

        }

        return res;

    }

    /**

     * Returns the description of group of arguments.

     *

     * @return the description of group of arguments

     */

    @NonNull

    public String getDescription() {

        return description;

    }

    /**

     * The list of the VM arguments.

     *

     * @return list of the VM arguments

     */

    @NonNull

    public List<String> getArguments() {

        return arguments;

    }

}

/*

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

 *

 * Copyright 2011 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 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.server.annotations;

import java.util.Set;

import javax.annotation.processing.Processor;

import javax.annotation.processing.RoundEnvironment;

import javax.annotation.processing.SupportedAnnotationTypes;

import javax.annotation.processing.SupportedSourceVersion;

import javax.lang.model.SourceVersion;

import javax.lang.model.element.Element;

import javax.lang.model.element.TypeElement;

import javax.lang.model.type.TypeMirror;

import org.netbeans.spi.server.VMArgumentsProvider;

import org.openide.filesystems.annotations.LayerBuilder.File;

import org.openide.filesystems.annotations.LayerGeneratingProcessor;

import org.openide.filesystems.annotations.LayerGenerationException;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Petr Hejl

 */

@SupportedAnnotationTypes("org.netbeans.spi.server.VMArgumentsProvider.Registration")

@ServiceProvider(service = Processor.class)

@SupportedSourceVersion(SourceVersion.RELEASE_6)

public class VMArgumentsRegistrationProcessor extends LayerGeneratingProcessor {

    public static final String PATH = "Servers/VmArgumentProviders";

    @Override

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

        for (Element element : roundEnv.getElementsAnnotatedWith(

                VMArgumentsProvider.Registration.class)) {

            File f = layer(element).instanceFile(PATH, null, VMArgumentsProvider.class)

                    .intvalue("position", element.getAnnotation(VMArgumentsProvider.Registration.class).position());

            f.write();

        }

        return true;

    }

}

/*

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

 *

 * Copyright 2011 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 2011 Sun Microsystems, Inc.

 */

package org.netbeans.spi.server;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

import java.util.List;

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

import org.netbeans.api.server.VMArguments;

/**

 * Provides the additional arguments to server VM. Typically the server plugin

 * implementor will query the arguments via API counterpart {@link VMArguments}.

 * Of course it is not mandatary for server plugin to use such arguments and

 * there is no way to force it.

 *

 * @author Petr Hejl

 * @since 1.18

 * @see VMArguments

 */

public interface VMArgumentsProvider {

    /**

     * Returns the description of the provider. For example this might be

     * "JRebel", "Profiler" etc.

     *

     * @return the description of the provider

     */

    @NonNull

    String getDescription();

    /**

     * Returns the list of arguments to pass to the server VM.

     *

     * @return the list of arguments to pass to the server VM

     */

    @NonNull

    List<String> getArguments();

    /**

     * Annotation used to properly register the SPI implementations.

     */

    @Retention(RetentionPolicy.SOURCE)

    @Target({ElementType.TYPE, ElementType.METHOD})

    public @interface Registration {

        /**

         * Position of the provider in the list of providers.

         */

        int position() default Integer.MAX_VALUE;

    }

}

                    <code-name-base>org.netbeans.modules.server</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>0-1</release-version>

                        <specification-version>1.18</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

import java.util.List;

import org.netbeans.api.server.VMArguments;

                if (mode != MODE_PROFILE) {

                    for (VMArguments args : VMArguments.getVMArguments()) {

                        for (String singleArg : args.getArguments()) {

                            sb.append(' ').append(singleArg);

                        }

                    }

                }