/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2010-2015 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
* http://glassfish.java.net/public/CDDL+GPL_1_1.html
* 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 org.glassfish.jersey.server.wadl.internal.generators.resourcedoc.model;
import java.util.ArrayList;
import java.util.List;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlAnyElement;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlElementWrapper;
import javax.xml.bind.annotation.XmlType;
/**
* The documentation type for methods.<br>
* Created on: Jun 12, 2008<br>
*
* @author Martin Grotzke (martin.grotzke at freiheit.com)
*/
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "methodDoc", propOrder = {
})
public class MethodDocType {
private String methodName;
@XmlElement(required = false, nillable = false)
protected String methodSignature;
protected String commentText;
private String returnDoc;
private String returnTypeExample;
private RequestDocType requestDoc;
private ResponseDocType responseDoc;
@XmlElementWrapper(name = "paramDocs")
protected List<ParamDocType> paramDoc;
public List<ParamDocType> getParamDocs() {
if (paramDoc == null) {
paramDoc = new ArrayList<>();
}
return this.paramDoc;
}
@XmlAnyElement(lax = true)
private List<Object> any;
public List<Object> getAny() {
if (any == null) {
any = new ArrayList<>();
}
return this.any;
}
/**
* Get the method name.
*
* @return the method name.
*/
public String getMethodName() {
return methodName;
}
/**
* Set the method name.
*
* @param methodName the method name to set.
*/
public void setMethodName(String methodName) {
this.methodName = methodName;
}
/**
* Get the method signature, or {@code null} if no method signature has been set for the method.
* <p>
* This string uniquely identifies the method in case there are multiple methods in the class with the same name.
* </p>
*
* @return unique method signature within a class.
* @since 2.20
*/
public String getMethodSignature() {
return methodSignature;
}
/**
* Set the unique method signature, including method parameters, if any.
*
* @param methodSignature method signature string to set.
* @since 2.20
*/
public void setMethodSignature(final String methodSignature) {
this.methodSignature = methodSignature;
}
/**
* Gets the value of the commentText property.
*
* @return the commentText
*/
public String getCommentText() {
return commentText;
}
/**
* Sets the value of the commentText property.
*
* @param value the commentText
*/
public void setCommentText(String value) {
this.commentText = value;
}
/**
* @return the returnDoc
*/
public String getReturnDoc() {
return returnDoc;
}
/**
* @param returnDoc the returnDoc to set
*/
public void setReturnDoc(String returnDoc) {
this.returnDoc = returnDoc;
}
/**
* @return the returnTypeExample
*/
public String getReturnTypeExample() {
return returnTypeExample;
}
/**
* @param returnTypeExample the returnTypeExample to set
*/
public void setReturnTypeExample(String returnTypeExample) {
this.returnTypeExample = returnTypeExample;
}
/**
* @return the requestDoc
*/
public RequestDocType getRequestDoc() {
return requestDoc;
}
/**
* @param requestDoc the requestDoc to set
*/
public void setRequestDoc(RequestDocType requestDoc) {
this.requestDoc = requestDoc;
}
/**
* @return the responseDoc
*/
public ResponseDocType getResponseDoc() {
return responseDoc;
}
/**
* @param responseDoc the responseDoc to set
*/
public void setResponseDoc(ResponseDocType responseDoc) {
this.responseDoc = responseDoc;
}
}