Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   * Copyright (c) 2010-2011 Oracle and/or its affiliates. All rights reserved.
   * 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
  * or packager/legal/LICENSE.txt.  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 packager/legal/LICENSE.txt.
  * GPL Classpath Exception:
  * 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.
  * Modifications:
  * If applicable, add the following below the License Header, with the fields
  * enclosed by brackets [] replaced by your own identifying information:
  * "Portions Copyright [year] [name of copyright owner]"
  * Contributor(s):
  * 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 don't 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.
 package com.sun.jersey.server.wadl.generators;
 import java.util.List;

This com.sun.jersey.server.wadl.WadlGenerator adds all doc elements provided by ApplicationDocs.getDocs() to the generated wadl-file.

The ApplicationDocs content can either be provided via a reference (setApplicationDocsFile( or via an (setApplicationDocsStream(

The should be used when using the maven-wadl-plugin for generating wadl offline, the should be used when the extended wadl is generated by jersey at runtime, e.g. using the com.sun.jersey.api.wadl.config.WadlGeneratorConfig for configuration.

Created on: Jun 16, 2008

Martin Grotzke
$Id: 5440 2011-10-21 07:50:38Z pavel_bucek $
 public class WadlGeneratorApplicationDoc implements WadlGenerator {
     private WadlGenerator _delegate;
     private File _applicationDocsFile;
     private ApplicationDocs _applicationDocs;
     public WadlGeneratorApplicationDoc() {
     public WadlGeneratorApplicationDoc(WadlGenerator wadlGeneratorApplicationDocs applicationDocs) {
          = wadlGenerator;
          = applicationDocs;
     public void setWadlGeneratorDelegate(WadlGenerator delegate) {
         = delegate;
        return .getRequiredJaxbContextPath();
    public void setApplicationDocsFile(File applicationDocsFile) {
        if (  != null ) {
            throw new IllegalStateException"The applicationDocsStream property is already set," +
                    " therefore you cannot set the applicationDocsFile property. Only one of both can be set at a time." );
         = applicationDocsFile;
    public void setApplicationDocsStream(InputStream applicationDocsStream) {
        if (  != null ) {
            throw new IllegalStateException"The applicationDocsFile property is already set," +
                    " therefore you cannot set the applicationDocsStream property. Only one of both can be set at a time." );
         = applicationDocsStream;
    public void init() throws Exception {
        if (  == null &&  == null ) {
            throw new IllegalStateException"Neither the applicationDocsFile nor the applicationDocsStream" +
                    " is set, one of both is required." );
        String name = ApplicationDocs.class.getName();
        final int i = name.lastIndexOf('.');
        name = (i != -1) ? name.substring(0, i) : "";
        final JAXBContext c = JAXBContext.newInstance(name,
        final Unmarshaller m = c.createUnmarshaller();
        final Object obj =  != null
            ? m.unmarshal ) : m.unmarshal );
         = ApplicationDocs.class.cast(obj);

    public Application createApplication() {
        final Application result = .createApplication();
        if ( != null && .getDocs() != null &&
                !.getDocs().isEmpty()) {
        return result;

        return .createMethod(rm);

            AbstractResourceMethod mMediaType mediaType) {
        return .createRequestRepresentation(rmmediaType);

        return .createRequest(rm);

            AbstractMethod mParameter p) {
        return .createParam(rmp);

    public Resource createResource(AbstractResource rString path) {
        return .createResource(rpath);

        return .createResponses(rm);

    public Resources createResources() {
        return .createResources();
    // ================ methods for post build actions =======================
        return .createExternalGrammar();
    public void attachTypes(ApplicationDescription egd) {
New to GrepCode? Check out our FAQ X