This commit is contained in:
Lana Steuck 2014-08-04 15:33:54 -07:00
commit 2e54393d4c
193 changed files with 413 additions and 342 deletions

View File

@ -127,7 +127,7 @@ public abstract class CommandMap {
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the CommandInfo classes that represent the command Beans.
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public CommandInfo[] getPreferredCommands(String mimeType, DataSource ds) {
return getPreferredCommands(mimeType);
@ -155,7 +155,7 @@ public abstract class CommandMap {
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the CommandInfo objects representing all the commands.
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public CommandInfo[] getAllCommands(String mimeType, DataSource ds) {
return getAllCommands(mimeType);
@ -183,7 +183,7 @@ public abstract class CommandMap {
* @param cmdName the command name
* @param ds a DataSource for the data
* @return the CommandInfo corresponding to the command.
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public CommandInfo getCommand(String mimeType, String cmdName,
DataSource ds) {
@ -215,7 +215,7 @@ public abstract class CommandMap {
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the DataContentHandler for the MIME type
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public DataContentHandler createDataContentHandler(String mimeType,
DataSource ds) {
@ -228,7 +228,7 @@ public abstract class CommandMap {
* null is returned.
*
* @return array of MIME types as strings, or null if not supported
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public String[] getMimeTypes() {
return null;

View File

@ -603,7 +603,7 @@ public class MailcapCommandMap extends CommandMap {
* Get all the MIME types known to this command map.
*
* @return array of MIME types as strings
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public synchronized String[] getMimeTypes() {
List mtList = new ArrayList();
@ -639,7 +639,7 @@ public class MailcapCommandMap extends CommandMap {
* MIME type are returned.
*
* @return array of native command entries
* @since JAF 1.1
* @since 1.6, JAF 1.1
*/
public synchronized String[] getNativeCommands(String mimeType) {
List cmdList = new ArrayList();

View File

@ -58,7 +58,7 @@ import javax.xml.stream.XMLStreamWriter;
* This class is responsible for whitespace normalization.
*
* @author <ul><li>Ryan Shoemaker, Martin Grebac</li></ul>
* @since JAXB1.0
* @since JAXB 1.0
* @deprecated in JAXB 2.2.4 - use javax.xml.bind.DatatypeConverterImpl instead
* or let us know why you can't
*/

View File

@ -31,7 +31,7 @@ import java.util.ResourceBundle;
/**
* Formats error messages.
*
* @since JAXB2.1.10
* @since JAXB 2.1.10
*/
enum Messages {

View File

@ -31,7 +31,7 @@ import java.util.ResourceBundle;
/**
* Formats error messages.
*
* @since JAXB1.0
* @since JAXB 1.0
*/
public class Messages
{

View File

@ -249,7 +249,7 @@ import org.xml.sax.helpers.XMLFilterImpl;
*
* @author David Megginson, david@megginson.com
* @version 0.2
* @since JAXB1.0
* @since JAXB 1.0
* @see org.xml.sax.XMLFilter
* @see org.xml.sax.ContentHandler
*/

View File

@ -55,7 +55,7 @@ import org.xml.sax.helpers.NamespaceSupport;
* classes like this.
*
* @author <ul><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li></ul>
* @since JAXB1.0
* @since JAXB 1.0
*/
public class DOMScanner implements LocatorEx,InfosetScanner/*<Node> --- but can't do this to protect 1.0 clients, or can I? */
{

View File

@ -31,7 +31,7 @@ import java.util.ResourceBundle;
/**
* Formats error messages.
*
* @since JAXB1.0
* @since JAXB 1.0
*/
public class Messages
{

View File

@ -62,7 +62,7 @@ import org.xml.sax.Attributes;
* AttributeList} interface, it also includes a much more efficient
* implementation using a single array rather than a set of Vectors.</p>
*
* @since JAXB1.0
* @since JAXB 1.0
* @since SAX 2.0
* @author David Megginson
* @version 2.0.1 (sax2r2)

View File

@ -262,7 +262,7 @@ import java.util.Map;
*
* @author David Megginson, david@megginson.com
* @version 0.2
* @since JAXB1.0
* @since JAXB 1.0
* @see org.xml.sax.XMLFilter
* @see org.xml.sax.ContentHandler
*/

View File

@ -43,7 +43,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* <p>The comment element is a place holder for any comments that the code
* generator may want to include in the generated code.</p>
*
* @since Common Annotations 1.0
* @since 1.6, Common Annotations 1.0
*/
@Documented

View File

@ -70,9 +70,10 @@ import static java.lang.annotation.RetentionPolicy.*;
* <li>If the method throws an unchecked exception the class MUST NOT be put into
* service except in the case of EJBs where the EJB can handle exceptions and
* even recover from them.</li></ul>
* @since Common Annotations 1.0
*
* @see javax.annotation.PreDestroy
* @see javax.annotation.Resource
* @since 1.6, Common Annotations 1.0
*/
@Documented
@Retention (RUNTIME)

View File

@ -72,7 +72,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* @see javax.annotation.PostConstruct
* @see javax.annotation.Resource
* @since Common Annotations 1.0
* @since 1.6, Common Annotations 1.0
*/
@Documented

View File

@ -48,7 +48,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* appear on private fields and methods of superclasses; the container
* is required to perform injection in these cases as well.
*
* @since Common Annotations 1.0
* @since 1.6, Common Annotations 1.0
*/
@Target({TYPE, FIELD, METHOD})
@Retention(RUNTIME)
@ -66,7 +66,7 @@ public @interface Resource {
* The name of the resource that the reference points to. It can
* link to any compatible resource using the global JNDI names.
*
* @since Common Annotations 1.1
* @since 1.7, Common Annotations 1.1
*/
String lookup() default "";

View File

@ -32,7 +32,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* This class is used to allow multiple resources declarations.
*
* @see javax.annotation.Resource
* @since Common Annotations 1.0
* @since 1.6, Common Annotations 1.0
*/
@Documented

View File

@ -28,6 +28,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({TYPE, METHOD, FIELD})
public @interface HandlerChain {

View File

@ -27,6 +27,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface Oneway {

View File

@ -27,6 +27,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface WebMethod {

View File

@ -27,6 +27,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({PARAMETER})
public @interface WebParam {

View File

@ -27,6 +27,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface WebResult {

View File

@ -27,6 +27,9 @@ package javax.jws;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebService {

View File

@ -25,7 +25,8 @@
package javax.jws.soap;
/*
/**
* @since 1.6
* @Deprecated
*/
@Deprecated public @interface InitParam {

View File

@ -27,6 +27,9 @@ package javax.jws.soap;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/**
* @since 1.6
*/
@Retention(value=RetentionPolicy.RUNTIME)
@Target({TYPE,METHOD})
public @interface SOAPBinding {

View File

@ -25,7 +25,8 @@
package javax.jws.soap;
/*
/**
* @since 1.6
* @Deprecated
*/
@Deprecated public @interface SOAPMessageHandler {

View File

@ -27,7 +27,8 @@ package javax.jws.soap;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
/*
/**
* @since 1.6
* @Deprecated
*/
@Retention(value=RetentionPolicy.RUNTIME)

View File

@ -76,7 +76,7 @@ import javax.xml.validation.Schema;
* Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
* Joseph Fialli
*
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public abstract class Binder<XmlNode> {
/**
@ -153,7 +153,7 @@ public abstract class Binder<XmlNode> {
* binding.
* @throws IllegalArgumentException
* If any of the input parameters are null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public abstract <T> JAXBElement<T>
unmarshal( XmlNode xmlNode, Class<T> declaredType )

View File

@ -34,7 +34,7 @@ package javax.xml.bind;
* is a checked exception.
*
* @see JAXB
* @since JAXB2.1
* @since 1.6, JAXB 2.1
*/
public class DataBindingException extends RuntimeException {
public DataBindingException(String message, Throwable cause) {

View File

@ -88,7 +88,7 @@ import javax.xml.namespace.NamespaceContext;
* @see DatatypeConverterInterface
* @see ParseConversionEvent
* @see PrintConversionEvent
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
final public class DatatypeConverter {

View File

@ -49,7 +49,7 @@ import javax.xml.datatype.DatatypeConfigurationException;
* This class is responsible for whitespace normalization.
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li></ul>
* @since JAXB2.1
* @since JAXB 2.1
*/
final class DatatypeConverterImpl implements DatatypeConverterInterface {

View File

@ -78,7 +78,7 @@ package javax.xml.bind;
* @see DatatypeConverter
* @see ParseConversionEvent
* @see PrintConversionEvent
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface DatatypeConverterInterface {

View File

@ -35,7 +35,7 @@ package javax.xml.bind;
* and 5.7.1 "Bind to Java Element Interface" of the specification.
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface Element {

View File

@ -92,7 +92,7 @@ import java.net.URLConnection;
* a non-null value.
*
* @author Kohsuke Kawaguchi
* @since 2.1
* @since 1.6, JAXB 2.1
*/
public final class JAXB {
/**

View File

@ -257,7 +257,7 @@ import java.io.InputStream;
* @see Marshaller
* @see Unmarshaller
* @see S 7.4.1 "Named Packages" in Java Language Specification</a>
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public abstract class JAXBContext {
@ -423,7 +423,7 @@ public abstract class JAXBContext {
* <li>failure to locate a value for the context factory provider property</li>
* <li>mixing schema derived packages from different providers on the same contextPath</li>
* </ol>
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public static JAXBContext newInstance( String contextPath, ClassLoader classLoader, Map<String,?> properties )
throws JAXBException {
@ -497,7 +497,7 @@ public abstract class JAXBContext {
// * @throws IllegalArgumentException
// * if the parameter contains {@code null} (i.e., {@code newInstance(null);})
// *
// * @since JAXB2.0
// * @since JAXB 2.0
// */
// public static JAXBContext newInstance( Source[] externalBindings, Class... classesToBeBound )
// throws JAXBException {
@ -576,7 +576,7 @@ public abstract class JAXBContext {
* @throws IllegalArgumentException
* if the parameter contains {@code null} (i.e., {@code newInstance(null);})
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public static JAXBContext newInstance( Class... classesToBeBound )
throws JAXBException {
@ -622,7 +622,7 @@ public abstract class JAXBContext {
* @throws IllegalArgumentException
* if the parameter contains {@code null} (i.e., {@code newInstance(null,someMap);})
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public static JAXBContext newInstance( Class[] classesToBeBound, Map<String,?> properties )
throws JAXBException {
@ -692,7 +692,7 @@ public abstract class JAXBContext {
* if DOM API corresponding to <tt>domType</tt> is not supported by
* the implementation.
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <T> Binder<T> createBinder(Class<T> domType) {
// to make JAXB 1.0 implementations work, this method must not be
@ -705,7 +705,7 @@ public abstract class JAXBContext {
*
* @return always a new valid <tt>Binder</tt> object.
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public Binder<Node> createBinder() {
return createBinder(Node.class);
@ -722,7 +722,7 @@ public abstract class JAXBContext {
* Calling this method on JAXB 1.0 implementations will throw
* an UnsupportedOperationException.
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public JAXBIntrospector createJAXBIntrospector() {
// to make JAXB 1.0 implementations work, this method must not be
@ -744,7 +744,7 @@ public abstract class JAXBContext {
* Calling this method on JAXB 1.0 implementations will throw
* an UnsupportedOperationException.
*
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public void generateSchema(SchemaOutputResolver outputResolver) throws IOException {
// to make JAXB 1.0 implementations work, this method must not be

View File

@ -58,7 +58,7 @@ import java.io.Serializable;
* </p>
*
* @author Kohsuke Kawaguchi, Joe Fialli
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public class JAXBElement<T> implements Serializable {

View File

@ -34,7 +34,7 @@ import java.io.PrintWriter;
* @see JAXBContext
* @see Marshaller
* @see Unmarshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class JAXBException extends Exception {

View File

@ -41,7 +41,7 @@ import javax.xml.namespace.QName;
* {@link JAXBContext#createJAXBIntrospector()}.
*
* @see JAXBContext#createJAXBIntrospector()
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public abstract class JAXBIntrospector {

View File

@ -73,7 +73,7 @@ import java.security.BasicPermission;
* @see java.lang.SecurityManager
*
* @author Joe Fialli
* @since JAXB 2.2
* @since 1.7, JAXB 2.2
*/
/* code was borrowed originally from java.lang.RuntimePermission. */

View File

@ -38,7 +38,7 @@ package javax.xml.bind;
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li></ul>
* @see JAXBException
* @see Marshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class MarshalException extends JAXBException {

View File

@ -311,7 +311,7 @@ import java.io.File;
* @see JAXBContext
* @see Validator
* @see Unmarshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface Marshaller {
@ -421,7 +421,7 @@ public interface Marshaller {
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
* @since JAXB2.1
* @since 1.6, JAXB 2.1
*/
public void marshal( Object jaxbElement, File output )
throws JAXBException;
@ -515,7 +515,7 @@ public interface Marshaller {
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public void marshal( Object jaxbElement, javax.xml.stream.XMLStreamWriter writer )
throws JAXBException;
@ -539,7 +539,7 @@ public interface Marshaller {
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public void marshal( Object jaxbElement, javax.xml.stream.XMLEventWriter writer )
throws JAXBException;
@ -655,7 +655,7 @@ public interface Marshaller {
* if the adapter parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public void setAdapter( XmlAdapter adapter );
@ -684,7 +684,7 @@ public interface Marshaller {
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> void setAdapter( Class<A> type, A adapter );
@ -697,7 +697,7 @@ public interface Marshaller {
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> A getAdapter( Class<A> type );
@ -730,7 +730,7 @@ public interface Marshaller {
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Marshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public void setSchema( Schema schema );
@ -745,7 +745,7 @@ public interface Marshaller {
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Marshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public Schema getSchema();
@ -766,7 +766,7 @@ public interface Marshaller {
*
* @see Marshaller#setListener(Listener)
* @see Marshaller#getListener()
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public static abstract class Listener {
/**
@ -807,7 +807,7 @@ public interface Marshaller {
* One can unregister current Listener by setting listener to <tt>null</tt>.
*
* @param listener an instance of a class that implements {@link Listener}
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public void setListener(Listener listener);
@ -815,7 +815,7 @@ public interface Marshaller {
* <p>Return {@link Listener} registered with this {@link Marshaller}.
*
* @return registered {@link Listener} or <code>null</code> if no Listener is registered with this Marshaller.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public Listener getListener();
}

View File

@ -32,7 +32,7 @@ package javax.xml.bind;
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @see Validator
* @see ValidationEventHandler
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface NotIdentifiableEvent extends ValidationEvent {

View File

@ -33,7 +33,7 @@ package javax.xml.bind;
* @see ValidationEvent
* @see ValidationEventHandler
* @see Unmarshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface ParseConversionEvent extends ValidationEvent {

View File

@ -33,7 +33,7 @@ package javax.xml.bind;
* @see ValidationEvent
* @see ValidationEventHandler
* @see Marshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface PrintConversionEvent extends ValidationEvent {

View File

@ -35,7 +35,7 @@ package javax.xml.bind;
* @see JAXBContext
* @see Validator
* @see Unmarshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class PropertyException extends JAXBException {

View File

@ -42,6 +42,7 @@ import java.io.IOException;
*
* @author
* Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
* @since 1.6
*/
public abstract class SchemaOutputResolver {
/**

View File

@ -42,7 +42,7 @@ package javax.xml.bind;
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @see ValidationEvent
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class TypeConstraintException extends java.lang.RuntimeException {

View File

@ -40,7 +40,7 @@ package javax.xml.bind;
* @see JAXBException
* @see Unmarshaller
* @see ValidationEventHandler
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class UnmarshalException extends JAXBException {

View File

@ -404,7 +404,7 @@ import java.io.Reader;
* @see JAXBContext
* @see Marshaller
* @see Validator
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface Unmarshaller {
@ -474,7 +474,7 @@ public interface Unmarshaller {
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the InputStream parameter is null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public Object unmarshal( Reader reader ) throws JAXBException;
@ -571,7 +571,7 @@ public interface Unmarshaller {
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( org.w3c.dom.Node node, Class<T> declaredType ) throws JAXBException;
@ -660,7 +660,7 @@ public interface Unmarshaller {
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.transform.Source source, Class<T> declaredType )
throws JAXBException;
@ -696,7 +696,7 @@ public interface Unmarshaller {
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLStreamReader, Class)
*/
public Object unmarshal( javax.xml.stream.XMLStreamReader reader )
@ -731,7 +731,7 @@ public interface Unmarshaller {
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.stream.XMLStreamReader reader, Class<T> declaredType ) throws JAXBException;
@ -766,7 +766,7 @@ public interface Unmarshaller {
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLEventReader, Class)
*/
public Object unmarshal( javax.xml.stream.XMLEventReader reader )
@ -802,7 +802,7 @@ public interface Unmarshaller {
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <T> JAXBElement<T> unmarshal( javax.xml.stream.XMLEventReader reader, Class<T> declaredType ) throws JAXBException;
@ -962,7 +962,7 @@ public interface Unmarshaller {
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Unmarshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public void setSchema( javax.xml.validation.Schema schema );
@ -986,7 +986,7 @@ public interface Unmarshaller {
* @throws UnsupportedOperationException could be thrown if this method is
* invoked on an Unmarshaller created from a JAXBContext referencing
* JAXB 1.0 mapped classes
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public javax.xml.validation.Schema getSchema();
@ -1001,7 +1001,7 @@ public interface Unmarshaller {
* if the adapter parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public void setAdapter( XmlAdapter adapter );
@ -1030,7 +1030,7 @@ public interface Unmarshaller {
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> void setAdapter( Class<A> type, A adapter );
@ -1043,7 +1043,7 @@ public interface Unmarshaller {
* if the type parameter is null.
* @throws UnsupportedOperationException
* if invoked agains a JAXB 1.0 implementation.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public <A extends XmlAdapter> A getAdapter( Class<A> type );
@ -1081,7 +1081,7 @@ public interface Unmarshaller {
* (@link #setListener(Listener)}
* (@link #getListener()}
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public static abstract class Listener {
/**
@ -1128,7 +1128,7 @@ public interface Unmarshaller {
* One can unregister current Listener by setting listener to <tt>null</tt>.
*
* @param listener provides unmarshal event callbacks for this {@link Unmarshaller}
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public void setListener(Listener listener);
@ -1136,7 +1136,7 @@ public interface Unmarshaller {
* <p>Return {@link Listener} registered with this {@link Unmarshaller}.
*
* @return registered {@link Listener} or <code>null</code> if no Listener is registered with this Unmarshaller.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public Listener getListener();
}

View File

@ -57,7 +57,7 @@ import org.xml.sax.ContentHandler;
*
* @author <ul><li>Kohsuke KAWAGUCHI, Sun Microsystems, Inc.</li></ul>
* @see Unmarshaller#getUnmarshallerHandler()
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface UnmarshallerHandler extends ContentHandler
{

View File

@ -34,7 +34,7 @@ package javax.xml.bind;
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @see Validator
* @see ValidationEventHandler
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface ValidationEvent {

View File

@ -65,7 +65,7 @@ package javax.xml.bind;
* @see Marshaller
* @see ValidationEvent
* @see javax.xml.bind.util.ValidationEventCollector
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface ValidationEventHandler {
/**

View File

@ -40,7 +40,7 @@ package javax.xml.bind;
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @see Validator
* @see ValidationEvent
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public interface ValidationEventLocator {

View File

@ -38,7 +38,7 @@ package javax.xml.bind;
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li></ul>
* @see JAXBException
* @see Validator
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public class ValidationException extends JAXBException {

View File

@ -154,7 +154,7 @@ package javax.xml.bind;
* @see ValidationEventHandler
* @see ValidationEvent
* @see javax.xml.bind.util.ValidationEventCollector
* @since JAXB1.0
* @since 1.6, JAXB 1.0
* @deprecated since JAXB 2.0
*/
public interface Validator {

View File

@ -49,7 +49,7 @@ import javax.xml.transform.Source;
* be called from applications.
*
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public interface DomHandler<ElementT,ResultT extends Result> {
/**

View File

@ -40,7 +40,7 @@ import javax.xml.transform.dom.DOMSource;
* {@link DomHandler} implementation for W3C DOM (<code>org.w3c.dom</code> package.)
*
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public class W3CDomHandler implements DomHandler<Element,DOMResult> {

View File

@ -30,7 +30,7 @@ package javax.xml.bind.annotation;
* fields in a JAXB bound class.
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see XmlAccessorOrder
*/

View File

@ -32,7 +32,7 @@ package javax.xml.bind.annotation;
* properties.
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see XmlAccessorType
*/

View File

@ -70,7 +70,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* following annotations at the package level: {@link XmlJavaTypeAdapter}.
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see XmlAccessOrder
*/

View File

@ -84,7 +84,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* following annotations at the package level: {@link XmlJavaTypeAdapter}.
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see XmlAccessType
*/

View File

@ -66,7 +66,7 @@ import static java.lang.annotation.ElementType.METHOD;
* map's key. The key's value is the String value of the attribute.
*
* @author Kohsuke Kawaguchi, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD})

View File

@ -243,7 +243,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* </pre>
*
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD})

View File

@ -66,7 +66,7 @@ import java.lang.annotation.Target;
* The above binding supports WS-I AP 1.0 <a href="http://www.ws-i.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html#Referencing_Attachments_from_the_SOAP_Envelope">WS-I Attachments Profile Version 1.0.</a>
*
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD,PARAMETER})

View File

@ -122,7 +122,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* </pre>
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @see XmlType
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD})

View File

@ -134,7 +134,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <p>
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD, PARAMETER})

View File

@ -130,7 +130,7 @@ import static java.lang.annotation.ElementType.METHOD;
* name "foo".
*
* @see XmlRegistry
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({METHOD})

View File

@ -216,7 +216,7 @@ import static java.lang.annotation.ElementType.METHOD;
*
* @author <ul><li>Kohsuke Kawaguchi, Sun Microsystems,Inc. </li><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li></ul>
* @see XmlElementRefs
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD})
@ -284,7 +284,7 @@ public @interface XmlElementRef {
* For compatibility with JAXB 2.1, this property defaults to <tt>true</tt>,
* despite the fact that {@link XmlElement#required()} defaults to false.
*
* @since 2.2
* @since 1.7, JAXB 2.2
*/
boolean required() default true;
}

View File

@ -50,7 +50,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
*
* @see XmlElementWrapper
* @see XmlElementRef
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD})

View File

@ -87,7 +87,7 @@ import java.lang.annotation.Target;
* @see XmlElements
* @see XmlElementRef
* @see XmlElementRefs
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*
*/
@ -139,7 +139,7 @@ public @interface XmlElementWrapper {
* simply a mechanism to let users express their application constraints
* better.
*
* @since JAXB 2.1
* @since 1.6, JAXB 2.1
*/
boolean required() default false;
}

View File

@ -166,7 +166,7 @@ import java.lang.annotation.Target;
* @see XmlElementRef
* @see XmlElementRefs
* @see XmlJavaTypeAdapter
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD,METHOD})
public @interface XmlElements {

View File

@ -62,7 +62,7 @@ import java.lang.annotation.Target;
*
* <p><b>Examples:</b> See examples in {@link XmlEnumValue}
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({TYPE})

View File

@ -114,7 +114,7 @@ import static java.lang.annotation.ElementType.FIELD;
* &lt;/xs:simpleType>
* </pre>
*
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD})

View File

@ -87,7 +87,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @see XmlIDREF
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD})

View File

@ -243,7 +243,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* </pre>
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @see XmlID
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD})

View File

@ -51,7 +51,7 @@ import javax.activation.DataHandler;
* ever called for the property. The binary data will always be inlined.
*
* @author Joseph Fialli
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD,TYPE})

View File

@ -104,7 +104,7 @@ import static java.lang.annotation.ElementType.PARAMETER;
* </ul>
*
* @author <ul><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li></ul>
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD,METHOD,PARAMETER})
public @interface XmlList {

View File

@ -47,7 +47,7 @@ import javax.xml.transform.Source;
* the value of the attribute takes precedence and that will control the marshalling.
*
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD,PARAMETER})

View File

@ -124,7 +124,7 @@ import javax.xml.bind.JAXBElement;
* <p>See "Package Specification" in javax.xml.bind.package javadoc for
* additional common information.</p>
* @author Kohsuke Kawaguchi
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({FIELD,METHOD})

View File

@ -42,7 +42,7 @@ import java.lang.annotation.Target;
*
* <p><b>Example:</b>See <tt>XmlSchema</tt> annotation type for an example.
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({})

View File

@ -61,6 +61,6 @@ package javax.xml.bind.annotation;
* </table>
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
public enum XmlNsForm {UNQUALIFIED, QUALIFIED, UNSET}

View File

@ -34,7 +34,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* Marks a class that has {@link XmlElementDecl}s.
*
* @author <ul><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li></ul>
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
* @see XmlElementDecl
*/
@Retention(RUNTIME)

View File

@ -155,7 +155,7 @@ import static java.lang.annotation.ElementType.TYPE;
* </pre>
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME)
@Target({TYPE})

View File

@ -114,7 +114,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* </pre>
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target(PACKAGE)
@ -191,7 +191,7 @@ public @interface XmlSchema {
* such attribute), for example so that the user can specify a local
* copy of the resource through the command line interface.
*
* @since JAXB2.1
* @since 1.6, JAXB 2.1
*/
String location() default NO_LOCATION;

View File

@ -83,7 +83,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* }
* </pre>
*
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD,METHOD,PACKAGE})

View File

@ -50,7 +50,7 @@ import java.lang.annotation.Target;
*
* @author <ul><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li></ul>
* @see XmlSchemaType
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({PACKAGE})
public @interface XmlSchemaTypes {

View File

@ -70,7 +70,7 @@ import java.lang.annotation.Target;
* correctly bind <tt>Dog</tt> and <tt>Cat</tt>.
*
* @author Kohsuke Kawaguchi
* @since JAXB2.1
* @since 1.6, JAXB 2.1
*/
@Target({ElementType.TYPE})
@Retention(RUNTIME)

View File

@ -88,7 +88,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* </pre>
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD, TYPE})

View File

@ -379,7 +379,7 @@ import java.lang.annotation.Target;
* @see XmlAttribute
* @see XmlValue
* @see XmlSchema
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({TYPE})

View File

@ -124,7 +124,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @see XmlType
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({FIELD, METHOD})

View File

@ -35,7 +35,7 @@ package javax.xml.bind.annotation.adapters;
* sequnce of tab, CR, LF, and SP by a single whitespace character ' '.
*
* @author Kohsuke Kawaguchi
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public class CollapsedStringAdapter extends XmlAdapter<String,String> {
/**

View File

@ -34,7 +34,7 @@ import javax.xml.bind.DatatypeConverter;
* This {@link XmlAdapter} binds <tt>byte[]</tt> to the hexBinary representation in XML.
*
* @author Kohsuke Kawaguchi
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public final class HexBinaryAdapter extends XmlAdapter<String,byte[]> {
public byte[] unmarshal(String s) {

View File

@ -35,7 +35,7 @@ package javax.xml.bind.annotation.adapters;
* as specified in <a href="http://www.w3.org/TR/xmlschema-2/#rf-whiteSpace">the whitespace facet 'replace'</a>
*
* @author Kohsuke Kawaguchi, Martin Grebac
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public final class NormalizedStringAdapter extends XmlAdapter<String,String> {
/**

View File

@ -160,7 +160,7 @@ package javax.xml.bind.annotation.adapters;
*
* @author <ul><li>Sekhar Vajjhala, Sun Microsystems Inc.</li> <li> Kohsuke Kawaguchi, Sun Microsystems Inc.</li></ul>
* @see XmlJavaTypeAdapter
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*/
public abstract class XmlAdapter<ValueType,BoundType> {

View File

@ -86,7 +86,7 @@ import static java.lang.annotation.ElementType.PACKAGE;
* <p><b> Example: </b> See example in {@link XmlAdapter}
*
* @author <ul><li>Sekhar Vajjhala, Sun Microsystems Inc.</li> <li> Kohsuke Kawaguchi, Sun Microsystems Inc.</li></ul>
* @since JAXB2.0
* @since 1.6, JAXB 2.0
* @see XmlAdapter
*/

View File

@ -51,7 +51,7 @@ import java.lang.annotation.Target;
*
* @author <ul><li>Sekhar Vajjhala, Sun Microsystems, Inc.</li></ul>
* @see XmlJavaTypeAdapter
* @since JAXB2.0
* @since 1.6, JAXB 2.0
*/
@Retention(RUNTIME) @Target({PACKAGE})
public @interface XmlJavaTypeAdapters {

View File

@ -279,7 +279,7 @@
</table>
<!-- Put @see and @since tags down here. -->
@since JAXB 2.0
@since 1.6, JAXB 2.0
</body>
</html>

View File

@ -50,7 +50,7 @@ import javax.xml.bind.Marshaller;
* @author Marc Hadley
* @author Kohsuke Kawaguchi
* @author Joseph Fialli
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*
* @see Marshaller#setAttachmentMarshaller(AttachmentMarshaller)
*

View File

@ -56,7 +56,7 @@ import javax.activation.DataHandler;
* @author Kohsuke Kawaguchi
* @author Joseph Fialli
*
* @since JAXB 2.0
* @since 1.6, JAXB 2.0
*
* @see javax.xml.bind.Unmarshaller#setAttachmentUnmarshaller(AttachmentUnmarshaller)
*

View File

@ -61,7 +61,7 @@
</ul>
<!-- Put @see and @since tags down here. -->
@since JAXB 2.0
@since 1.6, JAXB 2.0
</body>
</html>

View File

@ -62,7 +62,7 @@ import java.io.IOException;
*
* @author <ul><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li></ul>
* @see javax.xml.bind.Marshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public abstract class AbstractMarshallerImpl implements Marshaller
{

View File

@ -68,7 +68,7 @@ import java.net.URL;
* <li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li>
* </ul>
* @see javax.xml.bind.Unmarshaller
* @since JAXB1.0
* @since 1.6, JAXB 1.0
*/
public abstract class AbstractUnmarshallerImpl implements Unmarshaller
{

Some files were not shown because too many files have changed in this diff Show More