stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8133651: replace some <tt> tags (obsolete in html5) in core-libs docs

Browse Source 
Reviewed-by: martin
This commit is contained in:
Alexander Stepanov 2015-09-24 18:26:42 +03:00
parent 2a12715485
commit 291002bb8e
188 changed files with 882 additions and 863 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/CycleRecoverable.java
View File

@ -55,7 +55,7 @@ public interface CycleRecoverable {
*
*
* @return
* the object to be marshalled instead of <tt>this</tt> object.
* the object to be marshalled instead of {@code this} object.
* Or return null to indicate that the JAXB RI should behave
* just like when your object does not implement {@link CycleRecoverable}
* (IOW, cut the cycle arbitrarily and try to go on.)

6
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/IDResolver.java
View File

@ -134,10 +134,10 @@ public abstract class IDResolver {
* and it is used as the target object.
*
* <p>
* When a forward-reference happens, the <tt>call</tt> method
* When a forward-reference happens, the {@code call} method
* should return null. In this case the JAXB RI unmarshaller invokes
* the <tt>call</tt> method again after all the documents are fully unmarshalled.
* If the <tt>call</tt> method still returns null, then the JAXB RI unmarshaller
* the {@code call} method again after all the documents are fully unmarshalled.
* If the {@code call} method still returns null, then the JAXB RI unmarshaller
* treats it as an error.
*
* <p>

12
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/annotation/XmlIsSet.java
View File

@ -58,9 +58,9 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* marshaller.marshal(new Foo());
* </pre>
* and you get:
* <pre><xmp>
* <pre>{@code
* <foo><x>0</x></foo>
* </xmp></pre>
* }</pre>
*
* <p>
* By creating a side boolean field/property that has this annotation,
@ -81,14 +81,14 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
*
* marshaller.marshal(f);
*
* <xmp>
* {@code
* <foo/>
* </xmp>
* }
*
* f.xIsPresent = true;
* <xmp>
* {@code
* <foo><x>5</x></foo>
* </xmp>
* }
* </pre>
*
* <p>

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/api/ClassResolver.java
View File

@ -60,7 +60,7 @@ import com.sun.istack.internal.Nullable;
* <p>
* When an {@link Unmarshaller} encounters (i) an unknown root element or (ii) unknown
* elements where unmarshaller is trying to unmarshal into {@link XmlAnyElement} with
* <tt>lax=true</tt>, unmarshaller calls {@link #resolveElementName(String, String)}
* {@code lax=true}, unmarshaller calls {@link #resolveElementName(String, String)}
* method to see if the application may be able to supply a class that corresponds
* to that class.
*

12
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/api/JAXBRIContext.java
View File

@ -352,7 +352,7 @@ public abstract class JAXBRIContext extends JAXBContext {
* Accordingly, this method may return an identifier that collides with reserved words.
*
* <p>
* Use <tt>JJavaName.isJavaIdentifier(String)</tt> to check for such collision.
* Use {@code JJavaName.isJavaIdentifier(String)} to check for such collision.
*
* @return
* Typically, this method returns "nameLikeThis".
@ -394,17 +394,17 @@ public abstract class JAXBRIContext extends JAXBContext {
*
* <p>
* For example, given the following
* <pre><xmp>
* <pre>{@code
* interface Foo<T> extends List<List<T>> {}
* interface Bar extends Foo<String> {}
* </xmp></pre>
* }</pre>
* This method works like this:
* <pre><xmp>
* <pre>{@code
* getBaseClass( Bar, List ) = List<List<String>
* getBaseClass( Bar, Foo ) = Foo<String>
* getBaseClass( Foo<? extends Number>, Collection ) = Collection<List<? extends Number>>
* getBaseClass( ArrayList<? extends BigInteger>, List ) = List<? extends BigInteger>
* </xmp></pre>
* }</pre>
*
* @param type
* The type that derives from {@code baseType}
@ -460,7 +460,7 @@ public abstract class JAXBRIContext extends JAXBContext {
/**
* The property that you can specify to {@link JAXBContext#newInstance}
* to allow unmarshaller to honor <tt>xsi:nil</tt> anywhere, even if they are
* to allow unmarshaller to honor {@code xsi:nil} anywhere, even if they are
* not specifically allowed by the schema.
*
* Boolean

12
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/marshaller/NamespacePrefixMapper.java
View File

@ -125,7 +125,7 @@ public abstract class NamespacePrefixMapper {
* they are necessary, only at where they are used. Because of this
* lack of look-ahead, sometimes the marshaller produces a lot of
* namespace declarations that look redundant to human eyes. For example,
* <pre><xmp>
* <pre>{@code
* <?xml version="1.0"?>
* <root>
* <ns1:child xmlns:ns1="urn:foo"> ... </ns1:child>
@ -133,7 +133,7 @@ public abstract class NamespacePrefixMapper {
* <ns3:child xmlns:ns3="urn:foo"> ... </ns3:child>
* ...
* </root>
* </xmp></pre>
* }</pre>
*
* <p>
* The JAXB RI 2.x mostly doesn't exhibit this behavior any more,
@ -152,7 +152,7 @@ public abstract class NamespacePrefixMapper {
* <p>
* For example, by returning <code>new String[]{"urn:foo"}</code>,
* the marshaller will produce:
* <pre><xmp>
* <pre>{@code
* <?xml version="1.0"?>
* <root xmlns:ns1="urn:foo">
* <ns1:child> ... </ns1:child>
@ -160,7 +160,7 @@ public abstract class NamespacePrefixMapper {
* <ns1:child> ... </ns1:child>
* ...
* </root>
* </xmp></pre>
* }</pre>
* <p>
* To control prefixes assigned to those namespace URIs, use the
* {@link #getPreferredPrefix(String, String, boolean)} method.
@ -232,7 +232,7 @@ public abstract class NamespacePrefixMapper {
* the receiver a conflicting binding information.
* It's a responsibility of the caller to make sure that this doesn't happen
* even if the ancestor elements look like:
* <pre><xmp>
* <pre>{@code
* <foo:abc xmlns:foo="abc">
* <foo:abc xmlns:foo="def">
* <foo:abc xmlns:foo="abc">
@ -240,7 +240,7 @@ public abstract class NamespacePrefixMapper {
* </foo:abc>
* </foo:abc>
* </foo:abc>
* </xmp></pre>
* }</pre>
*
* @return
* always return a non-null (but possibly empty) array. The array stores

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/Adapter.java
View File

@ -46,7 +46,7 @@ public class Adapter<TypeT,ClassDeclT> {
/**
* The type that the JAXB can handle natively.
* The <tt>Default</tt> parameter of <tt>XmlAdapter&lt;Default,Custom></tt>.
* The {@code Default} parameter of {@code XmlAdapter<Default,Custom>}.
*
* Always non-null.
*/
@ -54,7 +54,7 @@ public class Adapter<TypeT,ClassDeclT> {
/**
* The type that is stored in memory.
* The <tt>Custom</tt> parameter of <tt>XmlAdapter&lt;Default,Custom></tt>.
* The {@code Custom} parameter of {@code XmlAdapter<Default,Custom>}.
*/
public final TypeT customType;

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/ClassInfo.java
View File

@ -143,8 +143,8 @@ public interface ClassInfo<T,C> extends MaybeElement<T,C> {
* False if it't not.
*
* <p>
* In RELAX NG context, ordered properties mean &lt;group> and
* unordered properties mean &lt;interleave>.
* In RELAX NG context, ordered properties mean {@code <group>} and
* unordered properties mean {@code <interleave>}.
*/
boolean isOrdered();

8
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/ElementPropertyInfo.java
View File

@ -56,9 +56,9 @@ public interface ElementPropertyInfo<T,C> extends PropertyInfo<T,C> {
* &#64;XmlElements({
* &#64;XmlElement(name="a",type=String.class),
* &#64;XmlElement(name="b",type=Integer.class),
* })
* List&lt;Object> abc;
* </pre>
* }) {@code
* List<Object> abc;
* }</pre>
* <p>
* In this case this method returns a list of two {@link TypeRef}s.
*
@ -107,7 +107,7 @@ public interface ElementPropertyInfo<T,C> extends PropertyInfo<T,C> {
* If {@link #isCollection()}==false, this property is always false.
*
* <p>
* When this flag is true, <tt>getTypes().size()==1</tt> always holds.
* When this flag is true, {@code getTypes().size()==1} always holds.
*/
boolean isValueList();

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/MapPropertyInfo.java
View File

@ -32,7 +32,7 @@ import javax.xml.namespace.QName;
/**
* Property that maps to the following schema fragment.
*
* <pre><xmp>
* <pre>{@code
* <xs:complexType>
* <xs:sequence>
* <xs:element name="entry" minOccurs="0" maxOccurs="unbounded">
@ -45,7 +45,7 @@ import javax.xml.namespace.QName;
* </xs:element>
* </xs:sequence>
* </xs:complexType>
* </xmp></pre>
* }</pre>
*
* <p>
* This property is used to represent a default binding of a {@link Map} property.

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/TypeInfoSet.java
View File

@ -153,7 +153,7 @@ public interface TypeInfoSet<T,C,F,M> {
* A map from namespace URI to the value of the location.
* If the entry is missing, that means a schema should be generated for that namespace.
* If the value is "", that means the schema location is implied
* (&lt;xs:schema namespace="..."/> w/o schemaLocation.)
* ({@code <xs:schema namespace="..."/>} w/o schemaLocation.)
*/
Map<String,String> getSchemaLocations();

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/AnyTypeImpl.java
View File

@ -35,7 +35,7 @@ import com.sun.xml.internal.bind.v2.model.nav.Navigator;
import com.sun.xml.internal.bind.v2.model.annotation.Locatable;
/**
* {@link TypeInfo} implementation for <tt>xs:anyType</tt>.
* {@link TypeInfo} implementation for {@code xs:anyType}.
*
* @author Kohsuke Kawaguchi
*/

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/TypeInfoSetImpl.java
View File

@ -119,7 +119,7 @@ class TypeInfoSetImpl<T,C,F,M> implements TypeInfoSet<T,C,F,M> {
};
/**
* {@link TypeInfo} for <tt>xs:anyType</tt>.
* {@link TypeInfo} for {@code xs:anyType}.
*
* anyType is the only {@link TypeInfo} that works with an interface,
* and accordingly it requires a lot of special casing.

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/GenericArrayTypeImpl.java
View File

@ -40,10 +40,10 @@ final class GenericArrayTypeImpl implements GenericArrayType {
}
/**
* Returns a <tt>Type</tt> object representing the component type
* Returns a {@code Type} object representing the component type
* of this array.
*
* @return a <tt>Type</tt> object representing the component type
* @return a {@code Type} object representing the component type
* of this array
* @since 1.5
*/

10
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/Navigator.java
View File

@ -70,17 +70,17 @@ public interface Navigator<T,C,F,M> {
*
* <p>
* For example, given the following
* <pre><xmp>
* <pre>{@code
* interface Foo<T> extends List<List<T>> {}
* interface Bar extends Foo<String> {}
* </xmp></pre>
* }</pre>
* This method works like this:
* <pre><xmp>
* getBaseClass( Bar, List ) = List<List<String>
* <pre>{@code
* getBaseClass( Bar, List ) = List<List<String>>
* getBaseClass( Bar, Foo ) = Foo<String>
* getBaseClass( Foo<? extends Number>, Collection ) = Collection<List<? extends Number>>
* getBaseClass( ArrayList<? extends BigInteger>, List ) = List<? extends BigInteger>
* </xmp></pre>
* }</pre>
*
* @param type
* The type that derives from {@code baseType}

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/ReflectionNavigator.java
View File

@ -418,7 +418,7 @@ import com.sun.xml.internal.bind.v2.runtime.Location;
}
/**
* Returns the {@link Type} object that represents {@code clazz&lt;T1,T2,T3>}.
* Returns the {@link Type} object that represents {@code clazz<T1,T2,T3>}.
*/
public Type createParameterizedType(Class rawType, Type... arguments) {
return new ParameterizedTypeImpl(rawType, arguments, null);

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/runtime/RuntimeArrayInfo.java
View File

@ -35,7 +35,7 @@ import com.sun.xml.internal.bind.v2.model.core.TypeInfo;
*/
public interface RuntimeArrayInfo extends ArrayInfo<Type,Class>, RuntimeNonElement {
/**
* Represents <tt>T[]</tt>.
* Represents {@code T[]}.
*
* The same as {@link TypeInfo#getType()} but at the runtime, an array
* is guaranteed to have a {@link Class} representation, not just any {@link Type}.

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/AnyTypeBeanInfo.java
View File

@ -48,7 +48,7 @@ import org.w3c.dom.NodeList;
import org.xml.sax.SAXException;
/**
* {@link JaxBeanInfo} for handling <tt>xs:anyType</tt>.
* {@link JaxBeanInfo} for handling {@code xs:anyType}.
*
* @author Kohsuke Kawaguchi
*/

14
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/IllegalAnnotationException.java
View File

@ -119,7 +119,7 @@ public class IllegalAnnotationException extends JAXBException {
* annotation, in which case this method returns a list that
* contains another list, which in turn contains the location
* information that leads to the error location
* (IOW, <tt>[ [pos1,pos2,...,posN] ]</tt>)
* (IOW, {@code [ [pos1,pos2,...,posN] ]})
*
* <p>
* Sometimes, an error could occur because of two or more conflicting
@ -127,12 +127,12 @@ public class IllegalAnnotationException extends JAXBException {
* that contains many lists, where each list contains
* the location information that leads to each of the conflicting
* annotations
* (IOW, <tt>[ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ]</tt>)
* (IOW, {@code [ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ]})
*
* <p>
* Yet some other time, the runtime can fail to provide any
* error location, in which case this method returns an empty list.
* (IOW, <tt>[]</tt>). We do try hard to make sure this won't happen,
* (IOW, {@code []}). We do try hard to make sure this won't happen,
* so please <a href="http://jaxb.dev.java.net/">let us know</a>
* if you see this behavior.
*
@ -146,13 +146,13 @@ public class IllegalAnnotationException extends JAXBException {
* to the first in the list, sort of like a stack trace.
*
* <p>
* For example, suppose you specify class <tt>Foo</tt> to {@link JAXBContext},
* <tt>Foo</tt> derives from <tt>Bar</tt>, <tt>Bar</tt> has a field <tt>pea</tt>
* that points to <tt>Zot</tt>, <tt>Zot</tt> contains a <tt>gum</tt>
* For example, suppose you specify class {@code Foo} to {@link JAXBContext},
* {@code Foo} derives from {@code Bar}, {@code Bar} has a field {@code pea}
* that points to {@code Zot}, {@code Zot} contains a {@code gum}
* property, and this property has an errornous annotation.
* Then when this exception is thrown, the list of {@link Location}s
* will look something like
* <tt>[ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]</tt>
* {@code [ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]}
*
*
* @return

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JAXBContextImpl.java
View File

@ -533,7 +533,7 @@ public final class JAXBContextImpl extends JAXBRIContext {
* This method traverses the base classes of the given object.
*
* @return null
* if <tt>c</tt> isn't a JAXB-bound class and <tt>fatal==false</tt>.
* if {@code c} isn't a JAXB-bound class and {@code fatal==false}.
*/
public final JaxBeanInfo getBeanInfo(Object o) {
// don't allow xs:anyType beanInfo to handle all the unbound objects
@ -577,7 +577,7 @@ public final class JAXBContextImpl extends JAXBRIContext {
* This method doesn't look for base classes.
*
* @return null
* if <tt>c</tt> isn't a JAXB-bound class and <tt>fatal==false</tt>.
* if {@code c} isn't a JAXB-bound class and {@code fatal==false}.
*/
public final <T> JaxBeanInfo<T> getBeanInfo(Class<T> clazz) {
return (JaxBeanInfo<T>)beanInfoMap.get(clazz);

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JaxBeanInfo.java
View File

@ -68,7 +68,7 @@ import org.xml.sax.SAXException;
* <p>
* Typically, {@link JaxBeanInfo} implementations should be generated
* by XJC/JXC. Those impl classes will register themselves to their
* master <tt>ObjectFactory</tt> class.
* master {@code ObjectFactory} class.
*
* <p>
* The type parameter BeanT is the Java class of the bean that this represents.

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/XMLSerializer.java
View File

@ -378,7 +378,7 @@ public final class XMLSerializer extends Coordinator {
* c.endElement();
* </pre>
*
* will generate <code>&lt;foo>abc def&lt;bar/>ghi&lt;/foo></code>.
* will generate {@code <foo>abc def<bar/>ghi</foo>}.
*/
public void text( String text, String fieldName ) throws SAXException, IOException, XMLStreamException {
// If the assertion fails, it must be a bug of xjc.
@ -492,7 +492,7 @@ public final class XMLSerializer extends Coordinator {
* When a cycle is found, this method tries to recover from it.
*
* @return
* the object that should be marshalled instead of the given <tt>obj</tt>,
* the object that should be marshalled instead of the given {@code obj},
* or null if the error is found and we need to avoid marshalling this object
* to prevent infinite recursion. When this method returns null, the error
* has already been reported.

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/property/SingleMapNodeProperty.java
View File

@ -134,7 +134,7 @@ final class SingleMapNodeProperty<BeanT,ValueT extends Map> extends PropertyImpl
private Loader valueLoader;
/**
* Handles &lt;items> and &lt;/items>.
* Handles {@code <items>} and {@code </items>}.
*
* The target will be set to a {@link Map}.
*/
@ -190,7 +190,7 @@ final class SingleMapNodeProperty<BeanT,ValueT extends Map> extends PropertyImpl
};
/**
* Handles &lt;entry> and &lt;/entry>.
* Handles {@code <entry>} and {@code </entry>}.
*
* The target will be set to a {@link Map}.
*/

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/reflect/Accessor.java
View File

@ -87,7 +87,7 @@ public abstract class Accessor<BeanT, ValueT> implements Receiver {
*
* @param context The {@link JAXBContextImpl} that owns the whole thing.
* (See {@link RuntimeModelBuilder#context}.)
* @return At least the implementation can return <tt>this</tt>.
* @return At least the implementation can return {@code this}.
*/
public Accessor<BeanT, ValueT> optimize(@Nullable JAXBContextImpl context) {
return this;

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/Loader.java
View File

@ -64,7 +64,7 @@ public abstract class Loader {
* and when the parent designated this loader as the child loader.
*
* <p>
* The callee may change <tt>state.loader</tt> to designate another {@link Loader}
* The callee may change {@code state.loader} to designate another {@link Loader}
* for the processing. It's the responsibility of the callee to forward the startElement
* event in such a case.
*

6
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/MTOMDecorator.java
View File

@ -58,9 +58,9 @@ final class MTOMDecorator implements XmlVisitor {
* UGLY HACK: we need to ignore the whitespace that follows
* the attached base64 image.
*
* This happens twice; once before &lt;/xop:Include>, another
* after &lt;/xop:Include>. The spec guarantees that
* no valid pcdata can follow &lt;/xop:Include>.
* This happens twice; once before {@code </xop:Include>}, another
* after {@code </xop:Include>}. The spec guarantees that
* no valid pcdata can follow {@code </xop:Include>}.
*/
private boolean followXop;

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/UnmarshallingContext.java
View File

@ -150,9 +150,9 @@ public final class UnmarshallingContext extends Coordinator
*
* <p>
* This flag is unused when {@link #assoc}==null.
* If it's non-null, then <tt>true</tt> indicates
* If it's non-null, then {@code true} indicates
* that we are doing in-place associative unmarshalling.
* If <tt>false</tt>, then we are doing associative unmarshalling
* If {@code false}, then we are doing associative unmarshalling
* without object reuse.
*/
private boolean isInplaceMode;

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/Form.java
View File

@ -72,7 +72,7 @@ enum Form {
}
/**
* Writes the attribute on the generated &lt;schema> element.
* Writes the attribute on the generated {@code <schema>} element.
*/
abstract void declare(String attName, Schema schema);

5
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/XmlSchemaGenerator.java
View File

@ -551,7 +551,7 @@ public final class XmlSchemaGenerator<T,C,F,M> {
/**
* Process the given PropertyInfo looking for references to namespaces that
* are foreign to the given namespace. Any foreign namespace references
* found are added to the given namespaces dependency list and an &lt;import>
* found are added to the given namespaces dependency list and an {@code <import>}
* is generated for it.
*
* @param p the PropertyInfo
@ -1140,7 +1140,8 @@ public final class XmlSchemaGenerator<T,C,F,M> {
/**
* Checks if we can collapse
* &lt;element name='foo' type='t' /> to &lt;element ref='foo' />.
* {@code <element name='foo' type='t' />}
* to {@code <element ref='foo' />}.
*
* This is possible if we already have such declaration to begin with.
*/

4
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/util/QNameMap.java
View File

@ -135,12 +135,12 @@ public final class QNameMap<V> {
/**
* Returns the value to which the specified keys are mapped in this QNameMap,
* or <tt>null</tt> if the map contains no mapping for this key.
* or {@code null} if the map contains no mapping for this key.
*
* @param nsUri the namespaceUri key whose associated value is to be returned.
* @param localPart the localPart key whose associated value is to be returned.
* @return the value to which this map maps the specified set of keya, or
* <tt>null</tt> if the map contains no mapping for this set of keys.
* {@code null} if the map contains no mapping for this set of keys.
* @see #put(String,String, Object)
*/
public V get( String nsUri, String localPart ) {

9
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/mimepull/MIMEParsingException.java
View File

@ -71,13 +71,14 @@ public class MIMEParsingException extends java.lang.RuntimeException {
/**
* Constructs a new WebServiceException with the specified cause
* and a detail message of <tt>(cause==null ? null :
* cause.toString())</tt> (which typically contains the
* class and detail message of <tt>cause</tt>).
* and a detail message of
* {@code (cause==null ? null : cause.toString())}
* (which typically contains the
* class and detail message of {@code cause}).
*
* @param cause The cause which is saved for the later
* retrieval throw by the getCause method.
* (A <tt>null</tt> value is permitted, and
* (A {@code null} value is permitted, and
* indicates that the cause is nonexistent or
* unknown.)
*/

10
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/NamespaceContextEx.java
View File

@ -42,19 +42,19 @@ public interface NamespaceContextEx extends NamespaceContext, Iterable<Namespace
* <p>
* This method enumerates all the active in-scope namespace bindings.
* This does not include implicit bindings, such as
* <tt>"xml"->"http://www.w3.org/XML/1998/namespace"</tt>
* or <tt>""->""</tt> (the implicit default namespace URI.)
* {@code "xml"->"http://www.w3.org/XML/1998/namespace"}
* or {@code ""->""} (the implicit default namespace URI.)
*
* <p>
* The returned iterator may not include the same prefix more than once.
* For example, the returned iterator may only contain <tt>f=ns2</tt>
* For example, the returned iterator may only contain {@code f=ns2}
* if the document is as follows and this method is used at the bar element.
*
* <pre><xmp>
* <pre>{@code
* <foo xmlns:f='ns1'>
* <bar xmlns:f='ns2'>
* ...
* </xmp></pre>
* }</pre>
*
* <p>
* The iteration may be done in no particular order.

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/XMLStreamReaderEx.java
View File

@ -111,7 +111,7 @@ public interface XMLStreamReaderEx extends XMLStreamReader {
// * if the parser is not pointing at characters infoset item.
// * @throws XMLStreamException
// * if the parser points to text but text is not base64-encoded text,
// * or if some other parsing error occurs (such as if the &lt;xop:Include>
// * or if some other parsing error occurs (such as if the {@code <xop:Include>}
// * points to a non-existing attachment.)
// *
// * <p>

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/Document.java
View File

@ -286,7 +286,7 @@ public final class Document {
* by using {@link #activeNamespaces}.
*
* @return
* the buffer passed as the <tt>buf</tt> parameter.
* the buffer passed as the {@code buf} parameter.
*/
private StringBuilder fixPrefix(StringBuilder buf) {
assert activeNamespaces!=null;

2
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/TypedXmlWriter.java
View File

@ -45,7 +45,7 @@ public interface TypedXmlWriter {
* Commits this element (and all its descendants) to the output.
*
* <p>
* Short for <tt>_commit(true)</tt>.
* Short for {@code _commit(true)}.
*/
void commit();

6
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlAttribute.java
View File

@ -37,12 +37,12 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* Specifies that the invocation of the method will produce an attribute.
*
* <p>
* The method signature has to match the form <tt>R foo(DT1,DT2,..)</tt>
* The method signature has to match the form {@code R foo(DT1,DT2,..)}
*
* <p>
* R is either <tt>void</tt> or the type to which the interface that declares
* R is either {@code void} or the type to which the interface that declares
* this method is assignable. In the case of the latter, the method will return
* <tt>this</tt> object, allowing you to chain the multiple attribute method
* {@code this} object, allowing you to chain the multiple attribute method
* invocations like {@link StringBuffer}.
*
* <p>

6
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlElement.java
View File

@ -50,13 +50,13 @@ import static java.lang.annotation.ElementType.METHOD;
* The method signature has to match one of the following patterns.
*
* <dl>
* <dt>Child writer: <tt>TW foo()</tt></dt>
* <dt>Child writer: {@code TW foo()}</dt>
* <dd>TW must be an interface derived from {@link TypedXmlWriter}.
* When this method is called, a new child element is started,
* and its content can be written by using the returned <tt>TW</tt>
* and its content can be written by using the returned {@code TW}
* object. This child element will be ended when its _commit method
* is called.
* <dt>Leaf element: <tt>void foo(DT1,DT2,...)</tt></dt>
* <dt>Leaf element: {@code void foo(DT1,DT2,...)}</dt>
* <dd>DTi must be datatype objects.
* When this method is called, a new child element is started,
* followed by the whitespace-separated text data from each of

6
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlValue.java
View File

@ -34,12 +34,12 @@ import java.lang.annotation.Target;
* Specifies that the invocation of the method will produce a text
*
* <p>
* The method signature has to match the form <tt>R foo(DT1,DT2,..)</tt>
* The method signature has to match the form {@code R foo(DT1,DT2,..)}
*
* <p>
* R is either <tt>void</tt> or the type to which the interface that declares
* R is either {@code void} or the type to which the interface that declares
* this method is assignable. In the case of the latter, the method will return
* <tt>this</tt> object, allowing you to chain the multiple method
* {@code this} object, allowing you to chain the multiple method
* invocations like {@link StringBuffer}.
*
* <p>

16
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/DataWriter.java
View File

@ -77,15 +77,15 @@ import java.util.Stack;
*
* <p>This code will produce the following document:</p>
*
* <pre>
* &lt;?xml version="1.0" standalone="yes"?>
* <pre>{@code
* <?xml version="1.0" standalone="yes"?>
*
* &lt;Person>
* &lt;name>Jane Smith&lt;/name>
* &lt;date-of-birth>1965-05-23&lt;/date-of-birth>
* &lt;citizenship>US&lt;/citizenship>
* &lt;/Person>
* </pre>
* <Person>
* <name>Jane Smith</name>
* <date-of-birth>1965-05-23</date-of-birth>
* <citizenship>US</citizenship>
* </Person>
* }</pre>
*
* <p>This class inherits from {@link XMLWriter},
* and provides all of the same support for Namespaces.</p>

80
jaxws/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/XMLWriter.java
View File

@ -93,11 +93,11 @@ import java.util.Map;
*
* <p>The resulting document will look like this:</p>
*
* <pre>
* &lt;?xml version="1.0" standalone="yes"?>
* <pre>{@code
* <?xml version="1.0" standalone="yes"?>
*
* &lt;greeting>Hello, world!&lt;/greeting>
* </pre>
* <greeting>Hello, world!</greeting>
* }</pre>
*
* <p>In fact, there is an even simpler convenience method,
* <var>dataElement</var>, designed for writing elements that
@ -127,9 +127,9 @@ import java.util.Map;
*
* <p>you will end up with</p>
*
* <pre>
* &lt;item>1&lt;/item>&lt;item>3&lt;/item>&lt;item>3&lt;/item>
* </pre>
* <pre>{@code
* <item>1</item><item>3</item><item>3</item>
* }</pre>
*
* <p>You need to invoke one of the <var>characters</var> methods
* explicitly to add newlines or indentation. Alternatively, you
@ -156,11 +156,11 @@ import java.util.Map;
*
* <p>The resulting document will look like this:</p>
*
* <pre>
* &lt;?xml version="1.0" standalone="yes"?>
* <pre>{@code
* <?xml version="1.0" standalone="yes"?>
*
* &lt;_NS1:foo xmlns:_NS1="http://www.foo.com/ns/"/>
* </pre>
* <_NS1:foo xmlns:_NS1="http://www.foo.com/ns/"/>
* }</pre>
*
* <p>In many cases, document authors will prefer to choose their
* own prefixes rather than using the (ugly) default names. The
@ -188,11 +188,11 @@ import java.util.Map;
*
* <p>The resulting document will look like this:</p>
*
* <pre>
* &lt;?xml version="1.0" standalone="yes"?>
* <pre>{@code
* <?xml version="1.0" standalone="yes"?>
*
* &lt;foo:foo xmlns:foo="http://www.foo.com/ns/"/>
* </pre>
* <foo:foo xmlns:foo="http://www.foo.com/ns/"/>
* }</pre>
*
* <p>The default Namespace simply uses an empty string as the prefix:</p>
*
@ -205,28 +205,28 @@ import java.util.Map;
*
* <p>The resulting document will look like this:</p>
*
* <pre>
* &lt;?xml version="1.0" standalone="yes"?>
* <pre>{@code
* <?xml version="1.0" standalone="yes"?>
*
* &lt;foo xmlns="http://www.foo.com/ns/"/>
* </pre>
* <foo xmlns="http://www.foo.com/ns/"/>
* }</pre>
*
* <p>By default, the XML writer will not declare a Namespace until
* it is actually used. Sometimes, this approach will create
* a large number of Namespace declarations, as in the following
* example:</p>
*
* <pre>
* &lt;xml version="1.0" standalone="yes"?>
* <pre>{@code
* <xml version="1.0" standalone="yes"?>
*
* &lt;rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
* &lt;rdf:Description about="http://www.foo.com/ids/books/12345">
* &lt;dc:title xmlns:dc="http://www.purl.org/dc/">A Dark Night&lt;/dc:title>
* &lt;dc:creator xmlns:dc="http://www.purl.org/dc/">Jane Smith&lt;/dc:title>
* &lt;dc:date xmlns:dc="http://www.purl.org/dc/">2000-09-09&lt;/dc:title>
* &lt;/rdf:Description>
* &lt;/rdf:RDF>
* </pre>
* <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
* <rdf:Description about="http://www.foo.com/ids/books/12345">
* <dc:title xmlns:dc="http://www.purl.org/dc/">A Dark Night</dc:title>
* <dc:creator xmlns:dc="http://www.purl.org/dc/">Jane Smith</dc:title>
* <dc:date xmlns:dc="http://www.purl.org/dc/">2000-09-09</dc:title>
* </rdf:Description>
* </rdf:RDF>
* }</pre>
*
* <p>The "rdf" prefix is declared only once, because the RDF Namespace
* is used by the root element and can be inherited by all of its
@ -243,18 +243,18 @@ import java.util.Map;
* though it's not needed there, and can be inherited by its
* descendants:</p>
*
* <pre>
* &lt;xml version="1.0" standalone="yes"?>
* <pre>{@code
* <xml version="1.0" standalone="yes"?>
*
* &lt;rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
* <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
* xmlns:dc="http://www.purl.org/dc/">
* &lt;rdf:Description about="http://www.foo.com/ids/books/12345">
* &lt;dc:title>A Dark Night&lt;/dc:title>
* &lt;dc:creator>Jane Smith&lt;/dc:title>
* &lt;dc:date>2000-09-09&lt;/dc:title>
* &lt;/rdf:Description>
* &lt;/rdf:RDF>
* </pre>
* <rdf:Description about="http://www.foo.com/ids/books/12345">
* <dc:title>A Dark Night</dc:title>
* <dc:creator>Jane Smith</dc:title>
* <dc:date>2000-09-09</dc:title>
* </rdf:Description>
* </rdf:RDF>
* }</pre>
*
* <p>This approach is also useful for declaring Namespace prefixes
* that be used by qualified names appearing in attribute values or
@ -388,7 +388,7 @@ public class XMLWriter extends XMLFilterImpl implements LexicalHandler
/**
* Set whether the writer should print out the XML declaration
* (&lt;?xml version='1.0' ... ?>).
* ({@code <?xml version='1.0' ... ?>}).
* <p>
* This option is set to true by default.
*/

32
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Binder.java
View File

@ -95,10 +95,10 @@ public abstract class Binder<XmlNode> {
* <p>
* This method throws {@link UnmarshalException} when the Binder's
* {@link JAXBContext} does not have a mapping for the XML element name
* or the type, specifiable via <tt>@xsi:type</tt>, of <tt>xmlNode</tt>
* or the type, specifiable via {@code @xsi:type}, of {@code xmlNode}
* to a JAXB mapped class. The method {@link #unmarshal(Object, Class)}
* enables an application to specify the JAXB mapped class that
* the <tt>xmlNode</tt> should be mapped to.
* the {@code xmlNode} should be mapped to.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
@ -110,8 +110,8 @@ public abstract class Binder<XmlNode> {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Binder</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If the node parameter is null
@ -119,7 +119,7 @@ public abstract class Binder<XmlNode> {
public abstract Object unmarshal( XmlNode xmlNode ) throws JAXBException;
/**
* Unmarshal XML root element by provided <tt>declaredType</tt>
* Unmarshal XML root element by provided {@code declaredType}
* to a JAXB object tree.
*
* <p>
@ -138,18 +138,18 @@ public abstract class Binder<XmlNode> {
* @param xmlNode
* the document/element to unmarshal XML data from.
* @param declaredType
* appropriate JAXB mapped class to hold <tt>node</tt>'s XML data.
* appropriate JAXB mapped class to hold {@code node}'s XML data.
*
* @return
* <a href="JAXBElement.html">JAXB Element</a> representation
* of <tt>node</tt>
* of {@code node}
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Binder</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If any of the input parameters are null
@ -182,9 +182,9 @@ public abstract class Binder<XmlNode> {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Binder</tt> is unable to marshal <tt>jaxbObject</tt> (or any
* object reachable from <tt>jaxbObject</tt>).
* returns false from its {@code handleEvent} method or the
* {@code Binder} is unable to marshal {@code jaxbObject} (or any
* object reachable from {@code jaxbObject}).
*
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -343,9 +343,9 @@ public abstract class Binder<XmlNode> {
public abstract Schema getSchema();
/**
* Allow an application to register a <tt>ValidationEventHandler</tt>.
* Allow an application to register a {@code ValidationEventHandler}.
* <p>
* The <tt>ValidationEventHandler</tt> will be called by the JAXB Provider
* The {@code ValidationEventHandler} will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* Binder unmarshal, marshal and update methods.
*
@ -373,7 +373,7 @@ public abstract class Binder<XmlNode> {
/**
*
* Set the particular property in the underlying implementation of
* <tt>Binder</tt>. This method can only be used to set one of
* {@code Binder}. This method can only be used to set one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to set an undefined property will result in
@ -397,7 +397,7 @@ public abstract class Binder<XmlNode> {
/**
* Get the particular property in the underlying implementation of
* <tt>Binder</tt>. This method can only
* {@code Binder}. This method can only
* be used to get one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/DataBindingException.java
View File

@ -30,7 +30,7 @@ package javax.xml.bind;
*
* <p>
* This exception differs from {@link JAXBException} in that
* this is an unchecked exception, while <tt>JAXBException</tt>
* this is an unchecked exception, while {@code JAXBException}
* is a checked exception.
*
* @see JAXB

26
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverter.java
View File

@ -294,7 +294,7 @@ final public class DatatypeConverter {
* Converts the string argument into a byte value.
*
* <p>
* String parameter <tt>lexicalXSDQname</tt> must conform to lexical value space specifed at
* String parameter {@code lexicalXSDQname} must conform to lexical value space specifed at
* <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part 2:Datatypes specification:QNames</a>
*
* @param lexicalXSDQName
@ -304,7 +304,7 @@ final public class DatatypeConverter {
* @return
* A QName value represented by the string argument.
* @throws IllegalArgumentException if string parameter does not conform to XML Schema Part 2 specification or
* if namespace prefix of <tt>lexicalXSDQname</tt> is not bound to a URI in NamespaceContext <tt>nsc</tt>.
* if namespace prefix of {@code lexicalXSDQname} is not bound to a URI in NamespaceContext {@code nsc}.
*/
public static javax.xml.namespace.QName parseQName( String lexicalXSDQName,
NamespaceContext nsc) {
@ -365,7 +365,7 @@ final public class DatatypeConverter {
* of xsd:unsignedInt.
* @return
* A long value represented by the string argument.
* @throws NumberFormatException if string parameter can not be parsed into a <tt>long</tt> value.
* @throws NumberFormatException if string parameter can not be parsed into a {@code long} value.
*/
public static long parseUnsignedInt( String lexicalXSDUnsignedInt ) {
if (theConverter == null) initConverter();
@ -380,7 +380,7 @@ final public class DatatypeConverter {
* representation of xsd:unsignedShort.
* @return
* An int value represented by the string argument.
* @throws NumberFormatException if string parameter can not be parsed into an <tt>int</tt> value.
* @throws NumberFormatException if string parameter can not be parsed into an {@code int} value.
*/
public static int parseUnsignedShort( String lexicalXSDUnsignedShort ) {
if (theConverter == null) initConverter();
@ -454,7 +454,7 @@ final public class DatatypeConverter {
* A BigInteger value
* @return
* A string containing a lexical representation of xsd:integer
* @throws IllegalArgumentException <tt>val</tt> is null.
* @throws IllegalArgumentException {@code val} is null.
*/
public static String printInteger( java.math.BigInteger val ) {
if (theConverter == null) initConverter();
@ -507,7 +507,7 @@ final public class DatatypeConverter {
* A BigDecimal value
* @return
* A string containing a lexical representation of xsd:decimal
* @throws IllegalArgumentException <tt>val</tt> is null.
* @throws IllegalArgumentException {@code val} is null.
*/
public static String printDecimal( java.math.BigDecimal val ) {
if (theConverter == null) initConverter();
@ -575,8 +575,8 @@ final public class DatatypeConverter {
* A namespace context for interpreting a prefix within a QName.
* @return
* A string containing a lexical representation of QName
* @throws IllegalArgumentException if <tt>val</tt> is null or
* if <tt>nsc</tt> is non-null or <tt>nsc.getPrefix(nsprefixFromVal)</tt> is null.
* @throws IllegalArgumentException if {@code val} is null or
* if {@code nsc} is non-null or {@code nsc.getPrefix(nsprefixFromVal)} is null.
*/
public static String printQName( javax.xml.namespace.QName val,
NamespaceContext nsc ) {
@ -591,7 +591,7 @@ final public class DatatypeConverter {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:dateTime
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public static String printDateTime( java.util.Calendar val ) {
if (theConverter == null) initConverter();
@ -605,7 +605,7 @@ final public class DatatypeConverter {
* An array of bytes
* @return
* A string containing a lexical representation of xsd:base64Binary
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public static String printBase64Binary( byte[] val ) {
if (theConverter == null) initConverter();
@ -619,7 +619,7 @@ final public class DatatypeConverter {
* An array of bytes
* @return
* A string containing a lexical representation of xsd:hexBinary
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public static String printHexBinary( byte[] val ) {
if (theConverter == null) initConverter();
@ -659,7 +659,7 @@ final public class DatatypeConverter {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:time
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public static String printTime( java.util.Calendar val ) {
if (theConverter == null) initConverter();
@ -673,7 +673,7 @@ final public class DatatypeConverter {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:date
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public static String printDate( java.util.Calendar val ) {
if (theConverter == null) initConverter();

26
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java
View File

@ -194,7 +194,7 @@ public interface DatatypeConverterInterface {
* Converts the string argument into a QName value.
*
* <p>
* String parameter <tt>lexicalXSDQname</tt> must conform to lexical value space specifed at
* String parameter {@code lexicalXSDQname} must conform to lexical value space specifed at
* <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part 2:Datatypes specification:QNames</a>
*
* @param lexicalXSDQName
@ -204,7 +204,7 @@ public interface DatatypeConverterInterface {
* @return
* A QName value represented by the string argument.
* @throws IllegalArgumentException if string parameter does not conform to XML Schema Part 2 specification or
* if namespace prefix of <tt>lexicalXSDQname</tt> is not bound to a URI in NamespaceContext <tt>nsc</tt>.
* if namespace prefix of {@code lexicalXSDQname} is not bound to a URI in NamespaceContext {@code nsc}.
*/
public javax.xml.namespace.QName parseQName( String lexicalXSDQName,
javax.xml.namespace.NamespaceContext nsc);
@ -249,7 +249,7 @@ public interface DatatypeConverterInterface {
* of xsd:unsignedInt.
* @return
* A long value represented by the string argument.
* @throws NumberFormatException if string parameter can not be parsed into a <tt>long</tt> value.
* @throws NumberFormatException if string parameter can not be parsed into a {@code long} value.
*/
public long parseUnsignedInt( String lexicalXSDUnsignedInt );
@ -260,7 +260,7 @@ public interface DatatypeConverterInterface {
* representation of xsd:unsignedShort.
* @return
* An int value represented by the string argument.
* @throws NumberFormatException if string parameter can not be parsed into an <tt>int</tt> value.
* @throws NumberFormatException if string parameter can not be parsed into an {@code int} value.
*/
public int parseUnsignedShort( String lexicalXSDUnsignedShort );
@ -313,7 +313,7 @@ public interface DatatypeConverterInterface {
* A BigInteger value
* @return
* A string containing a lexical representation of xsd:integer
* @throws IllegalArgumentException <tt>val</tt> is null.
* @throws IllegalArgumentException {@code val} is null.
*/
public String printInteger( java.math.BigInteger val );
@ -351,7 +351,7 @@ public interface DatatypeConverterInterface {
* A BigDecimal value
* @return
* A string containing a lexical representation of xsd:decimal
* @throws IllegalArgumentException <tt>val</tt> is null.
* @throws IllegalArgumentException {@code val} is null.
*/
public String printDecimal( java.math.BigDecimal val );
@ -399,8 +399,8 @@ public interface DatatypeConverterInterface {
* A namespace context for interpreting a prefix within a QName.
* @return
* A string containing a lexical representation of QName
* @throws IllegalArgumentException if <tt>val</tt> is null or
* if <tt>nsc</tt> is non-null or <tt>nsc.getPrefix(nsprefixFromVal)</tt> is null.
* @throws IllegalArgumentException if {@code val} is null or
* if {@code nsc} is non-null or {@code nsc.getPrefix(nsprefixFromVal)} is null.
*/
public String printQName( javax.xml.namespace.QName val,
javax.xml.namespace.NamespaceContext nsc );
@ -411,7 +411,7 @@ public interface DatatypeConverterInterface {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:dateTime
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public String printDateTime( java.util.Calendar val );
@ -421,7 +421,7 @@ public interface DatatypeConverterInterface {
* an array of bytes
* @return
* A string containing a lexical representation of xsd:base64Binary
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public String printBase64Binary( byte[] val );
@ -431,7 +431,7 @@ public interface DatatypeConverterInterface {
* an array of bytes
* @return
* A string containing a lexical representation of xsd:hexBinary
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public String printHexBinary( byte[] val );
@ -459,7 +459,7 @@ public interface DatatypeConverterInterface {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:time
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public String printTime( java.util.Calendar val );
@ -469,7 +469,7 @@ public interface DatatypeConverterInterface {
* A Calendar value
* @return
* A string containing a lexical representation of xsd:date
* @throws IllegalArgumentException if <tt>val</tt> is null.
* @throws IllegalArgumentException if {@code val} is null.
*/
public String printDate( java.util.Calendar val );

32
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/JAXB.java
View File

@ -68,7 +68,7 @@ import java.net.URLConnection;
* </ol>
*
* <p>
* In addition, the <tt>unmarshal</tt> methods have the following characteristic:
* In addition, the {@code unmarshal} methods have the following characteristic:
*
* <ol>
* <li>Schema validation is not performed on the input XML.
@ -78,7 +78,7 @@ import java.net.URLConnection;
* </ol>
*
* <p>
* Similarly, the <tt>marshal</tt> methods have the following characteristic:
* Similarly, the {@code marshal} methods have the following characteristic:
* <ol>
* <li>The processing will try to continue even if the Java object tree
* does not meet the validity requirement. Only as
@ -88,7 +88,7 @@ import java.net.URLConnection;
*
* <p>
* All the methods on this class require non-null arguments to all parameters.
* The <tt>unmarshal</tt> methods either fail with an exception or return
* The {@code unmarshal} methods either fail with an exception or return
* a non-null value.
*
* @author Kohsuke Kawaguchi
@ -179,7 +179,7 @@ public final class JAXB {
*
* @param xml
* The URI is {@link URI#toURL() turned into URL} and then
* follows the handling of <tt>URL</tt>.
* follows the handling of {@code URL}.
*/
public static <T> T unmarshal( URI xml, Class<T> type ) {
try {
@ -196,9 +196,9 @@ public final class JAXB {
* Reads in a Java object tree from the given XML input.
*
* @param xml
* The string is first interpreted as an absolute <tt>URI</tt>.
* The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
* then it's interpreted as a <tt>File</tt>
* then it's interpreted as a {@code File}
*/
public static <T> T unmarshal( String xml, Class<T> type ) {
try {
@ -347,8 +347,8 @@ public final class JAXB {
*
* @param xml
* The XML will be {@link URLConnection#getOutputStream() sent} to the
* resource pointed by this URL. Note that not all <tt>URL</tt>s support
* such operation, and exact semantics depends on the <tt>URL</tt>
* resource pointed by this URL. Note that not all {@code URL}s support
* such operation, and exact semantics depends on the {@code URL}
* implementations. In case of {@link HttpURLConnection HTTP URLs},
* this will perform HTTP POST.
*
@ -374,7 +374,7 @@ public final class JAXB {
*
* @param xml
* The URI is {@link URI#toURL() turned into URL} and then
* follows the handling of <tt>URL</tt>. See above.
* follows the handling of {@code URL}. See above.
*
* @throws DataBindingException
* If the operation fails, such as due to I/O error, unbindable classes.
@ -397,9 +397,9 @@ public final class JAXB {
* This parameter must not be null.
*
* @param xml
* The string is first interpreted as an absolute <tt>URI</tt>.
* The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
* then it's interpreted as a <tt>File</tt>
* then it's interpreted as a {@code File}
*
* @throws DataBindingException
* If the operation fails, such as due to I/O error, unbindable classes.
@ -522,19 +522,19 @@ public final class JAXB {
* </tr><tr>
* <td>{@link URL}</td>
* <td>The XML will be {@link URLConnection#getOutputStream() sent} to the
* resource pointed by this URL. Note that not all <tt>URL</tt>s support
* such operation, and exact semantics depends on the <tt>URL</tt>
* resource pointed by this URL. Note that not all {@code URL}s support
* such operation, and exact semantics depends on the {@code URL}
* implementations. In case of {@link HttpURLConnection HTTP URLs},
* this will perform HTTP POST.</td>
* </tr><tr>
* <td>{@link URI}</td>
* <td>The URI is {@link URI#toURL() turned into URL} and then
* follows the handling of <tt>URL</tt>. See above.</td>
* follows the handling of {@code URL}. See above.</td>
* </tr><tr>
* <td>{@link String}</td>
* <td>The string is first interpreted as an absolute <tt>URI</tt>.
* <td>The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
* then it's interpreted as a <tt>File</tt></td>
* then it's interpreted as a {@code File}</td>
* </tr><tr>
* <td>{@link OutputStream}</td>
* <td>The XML will be sent to the given {@link OutputStream}.

14
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContextFactory.java
View File

@ -38,7 +38,7 @@ public interface JAXBContextFactory {
/**
* <p>
* Create a new instance of a <tt>JAXBContext</tt> class.
* Create a new instance of a {@code JAXBContext} class.
*
* <p>
* For semantics see {@link javax.xml.bind.JAXBContext#newInstance(Class[], java.util.Map)}
@ -52,11 +52,11 @@ public interface JAXBContextFactory {
* in an empty map.
*
* @return
* A new instance of a <tt>JAXBContext</tt>.
* A new instance of a {@code JAXBContext}.
*
* @throws JAXBException
* if an error was encountered while creating the
* <tt>JAXBContext</tt>, such as (but not limited to):
* {@code JAXBContext}, such as (but not limited to):
* <ol>
* <li>Classes use JAXB annotations incorrectly
* <li>Classes have colliding annotations (i.e., two classes with the same type name)
@ -75,14 +75,14 @@ public interface JAXBContextFactory {
/**
* <p>
* Create a new instance of a <tt>JAXBContext</tt> class.
* Create a new instance of a {@code JAXBContext} class.
*
* <p>
* For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
*
* <p>
* The interpretation of properties is up to implementations. Implementations should
* throw <tt>JAXBException</tt> if it finds properties that it doesn't understand.
* throw {@code JAXBException} if it finds properties that it doesn't understand.
*
* @param contextPath list of java package names that contain schema derived classes
* @param classLoader
@ -91,9 +91,9 @@ public interface JAXBContextFactory {
* provider-specific properties. Can be null, which means the same thing as passing
* in an empty map.
*
* @return a new instance of a <tt>JAXBContext</tt>
* @return a new instance of a {@code JAXBContext}
* @throws JAXBException if an error was encountered while creating the
* <tt>JAXBContext</tt> such as
* {@code JAXBContext} such as
* <ol>
* <li>failure to locate either ObjectFactory.class or jaxb.index in the packages</li>
* <li>an ambiguity among global elements contained in the contextPath</li>

38
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/JAXBElement.java
View File

@ -35,25 +35,25 @@ import java.io.Serializable;
* declaration within a schema and the element instance value within an xml document
* with the following properties
* <ul>
* <li>element's xml tag <b><tt>name</tt></b></li>
* <li><b><tt>value</tt></b> represents the element instance's atttribute(s) and content model</li>
* <li>element declaration's <b><tt>declaredType</tt></b> (<tt>xs:element @type</tt> attribute)</li>
* <li><b><tt>scope</tt></b> of element declaration</li>
* <li>boolean <b><tt>nil</tt></b> property. (element instance's <tt><b>xsi:nil</b></tt> attribute)</li>
* <li>element's xml tag <b>{@code name}</b></li>
* <li><b>{@code value}</b> represents the element instance's atttribute(s) and content model</li>
* <li>element declaration's <b>{@code declaredType}</b> ({@code xs:element @type} attribute)</li>
* <li><b>{@code scope}</b> of element declaration</li>
* <li>boolean <b>{@code nil}</b> property. (element instance's <b>{@code xsi:nil}</b> attribute)</li>
* </ul>
*
* <p>The <tt>declaredType</tt> and <tt>scope</tt> property are the
* <p>The {@code declaredType} and {@code scope} property are the
* JAXB class binding for the xml type definition.
* </p>
*
* <p><b><tt>Scope</tt></b> is either {@link GlobalScope} or the Java class representing the
* <p><b>{@code Scope}</b> is either {@link GlobalScope} or the Java class representing the
* complex type definition containing the schema element declaration.
* </p>
*
* <p>There is a property constraint that if <b><tt>value</tt></b> is <tt>null</tt>,
* then <tt>nil</tt> must be <tt>true</tt>. The converse is not true to enable
* representing a nil element with attribute(s). If <tt>nil</tt> is true, it is possible
* that <tt>value</tt> is non-null so it can hold the value of the attributes
* <p>There is a property constraint that if <b>{@code value}</b> is {@code null},
* then {@code nil} must be {@code true}. The converse is not true to enable
* representing a nil element with attribute(s). If {@code nil} is true, it is possible
* that {@code value} is non-null so it can hold the value of the attributes
* associated with a nil element.
* </p>
*
@ -97,7 +97,7 @@ public class JAXBElement<T> implements Serializable {
* @param declaredType Java binding of xml element declaration's type
* @param scope
* Java binding of scope of xml element declaration.
* Passing null is the same as passing <tt>GlobalScope.class</tt>
* Passing null is the same as passing {@code GlobalScope.class}
* @param value
* Java instance representing xml element's value.
* @see #getScope()
@ -119,7 +119,7 @@ public class JAXBElement<T> implements Serializable {
/**
* Construct an xml element instance.
*
* This is just a convenience method for <tt>new JAXBElement(name,declaredType,GlobalScope.class,value)</tt>
* This is just a convenience method for {@code new JAXBElement(name,declaredType,GlobalScope.class,value)}
*/
public JAXBElement(QName name, Class<T> declaredType, T value ) {
this(name,declaredType,GlobalScope.class,value);
@ -142,7 +142,7 @@ public class JAXBElement<T> implements Serializable {
/**
* <p>Set the content model and attributes of this xml element.</p>
*
* <p>When this property is set to <tt>null</tt>, <tt>isNil()</tt> must by <tt>true</tt>.
* <p>When this property is set to {@code null}, {@code isNil()} must by {@code true}.
* Details of constraint are described at {@link #isNil()}.</p>
*
* @see #isTypeSubstituted()
@ -155,7 +155,7 @@ public class JAXBElement<T> implements Serializable {
* <p>Return the content model and attribute values for this element.</p>
*
* <p>See {@link #isNil()} for a description of a property constraint when
* this value is <tt>null</tt></p>
* this value is {@code null}</p>
*/
public T getValue() {
return value;
@ -165,18 +165,18 @@ public class JAXBElement<T> implements Serializable {
* Returns scope of xml element declaration.
*
* @see #isGlobalScope()
* @return <tt>GlobalScope.class</tt> if this element is of global scope.
* @return {@code GlobalScope.class} if this element is of global scope.
*/
public Class getScope() {
return scope;
}
/**
* <p>Returns <tt>true</tt> iff this element instance content model
* <p>Returns {@code true} iff this element instance content model
* is nil.</p>
*
* <p>This property always returns <tt>true</tt> when {@link #getValue()} is null.
* Note that the converse is not true, when this property is <tt>true</tt>,
* <p>This property always returns {@code true} when {@link #getValue()} is null.
* Note that the converse is not true, when this property is {@code true},
* {@link #getValue()} can contain a non-null value for attribute(s). It is
* valid for a nil xml element to have attribute(s).</p>
*/

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/JAXBException.java
View File

@ -160,7 +160,7 @@ public class JAXBException extends Exception {
/**
* Prints this JAXBException and its stack trace (including the stack trace
* of the linkedException if it is non-null) to <tt>System.err</tt>.
* of the linkedException if it is non-null) to {@code System.err}.
*
*/
public void printStackTrace() {

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/JAXBIntrospector.java
View File

@ -74,7 +74,7 @@ public abstract class JAXBIntrospector {
*
* <p>Convenience method to abstract whether working with either
* a javax.xml.bind.JAXBElement instance or an instance of
* <tt>@XmlRootElement</tt> annotated Java class.</p>
* {@code @XmlRootElement} annotated Java class.</p>
*
* @param jaxbElement object that #isElement(Object) returns true.
*

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/MarshalException.java
View File

@ -30,7 +30,7 @@ package javax.xml.bind;
* a marshal operation that the provider is unable to recover from.
*
* <p>
* The <tt>ValidationEventHandler</tt> can cause this exception to be thrown
* The {@code ValidationEventHandler} can cause this exception to be thrown
* during the marshal operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.

117
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java
View File

@ -33,7 +33,7 @@ import java.io.File;
/**
* <p>
* The <tt>Marshaller</tt> class is responsible for governing the process
* The {@code Marshaller} class is responsible for governing the process
* of serializing Java content trees back into XML data. It provides the basic
* marshalling methods:
*
@ -153,15 +153,15 @@ import java.io.File;
* <b>Marshalling content tree rooted by a JAXB element</b><br>
* <blockquote>
* The first parameter of the overloaded
* <tt>Marshaller.marshal(java.lang.Object, ...)</tt> methods must be a
* {@code Marshaller.marshal(java.lang.Object, ...)} methods must be a
* JAXB element as computed by
* {@link JAXBIntrospector#isElement(java.lang.Object)};
* otherwise, a <tt>Marshaller.marshal</tt> method must throw a
* otherwise, a {@code Marshaller.marshal} method must throw a
* {@link MarshalException}. There exist two mechanisms
* to enable marshalling an instance that is not a JAXB element.
* One method is to wrap the instance as a value of a {@link JAXBElement},
* and pass the wrapper element as the first parameter to
* a <tt>Marshaller.marshal</tt> method. For java to schema binding, it
* a {@code Marshaller.marshal} method. For java to schema binding, it
* is also possible to simply annotate the instance's class with
* &#64;{@link XmlRootElement}.
* </blockquote>
@ -170,7 +170,7 @@ import java.io.File;
* <b>Encoding</b><br>
* <blockquote>
* By default, the Marshaller will use UTF-8 encoding when generating XML data
* to a <tt>java.io.OutputStream</tt>, or a <tt>java.io.Writer</tt>. Use the
* to a {@code java.io.OutputStream}, or a {@code java.io.Writer}. Use the
* {@link #setProperty(String,Object) setProperty} API to change the output
* encoding used during these marshal operations. Client applications are
* expected to supply a valid character encoding name as defined in the
@ -188,7 +188,7 @@ import java.io.File;
* order to marshal it back into XML data. Different JAXB Providers will
* support marshalling invalid Java content trees at varying levels, however
* all JAXB Providers must be able to marshal a valid content tree back to
* XML data. A JAXB Provider must throw a <tt>MarshalException</tt> when it
* XML data. A JAXB Provider must throw a {@code MarshalException} when it
* is unable to complete the marshal operation due to invalid content. Some
* JAXB Providers will fully allow marshalling invalid content, others will fail
* on the first validation error.
@ -213,18 +213,18 @@ import java.io.File;
* All JAXB Providers are required to support the following set of properties.
* Some providers may support additional properties.
* <dl>
* <dt><tt>jaxb.encoding</tt> - value must be a java.lang.String</dt>
* <dt>{@code jaxb.encoding} - value must be a java.lang.String</dt>
* <dd>The output encoding to use when marshalling the XML data. The
* Marshaller will use "UTF-8" by default if this property is not
* specified.</dd>
* <dt><tt>jaxb.formatted.output</tt> - value must be a java.lang.Boolean</dt>
* <dt>{@code jaxb.formatted.output} - value must be a java.lang.Boolean</dt>
* <dd>This property controls whether or not the Marshaller will format
* the resulting XML data with line breaks and indentation. A
* true value for this property indicates human readable indented
* xml data, while a false value indicates unformatted xml data.
* The Marshaller will default to false (unformatted) if this
* property is not specified.</dd>
* <dt><tt>jaxb.schemaLocation</tt> - value must be a java.lang.String</dt>
* <dt>{@code jaxb.schemaLocation} - value must be a java.lang.String</dt>
* <dd>This property allows the client application to specify an
* xsi:schemaLocation attribute in the generated XML data. The format of
* the schemaLocation attribute value is discussed in an easy to
@ -233,7 +233,7 @@ import java.io.File;
* of the W3C XML Schema Part 0: Primer</a> and specified in
* <a href="http://www.w3.org/TR/xmlschema-1/#Instance_Document_Constructions">
* Section 2.6 of the W3C XML Schema Part 1: Structures</a>.</dd>
* <dt><tt>jaxb.noNamespaceSchemaLocation</tt> - value must be a java.lang.String</dt>
* <dt>{@code jaxb.noNamespaceSchemaLocation} - value must be a java.lang.String</dt>
* <dd>This property allows the client application to specify an
* xsi:noNamespaceSchemaLocation attribute in the generated XML
* data. The format of the schemaLocation attribute value is discussed in
@ -242,10 +242,10 @@ import java.io.File;
* of the W3C XML Schema Part 0: Primer</a> and specified in
* <a href="http://www.w3.org/TR/xmlschema-1/#Instance_Document_Constructions">
* Section 2.6 of the W3C XML Schema Part 1: Structures</a>.</dd>
* <dt><tt>jaxb.fragment</tt> - value must be a java.lang.Boolean</dt>
* <dt>{@code jaxb.fragment} - value must be a java.lang.Boolean</dt>
* <dd>This property determines whether or not document level events will be
* generated by the Marshaller. If the property is not specified, the
* default is <tt>false</tt>. This property has different implications depending
* default is {@code false}. This property has different implications depending
* on which marshal api you are using - when this property is set to true:<br>
* <ul>
* <li>{@link #marshal(Object,org.xml.sax.ContentHandler) marshal(Object,ContentHandler)} - the Marshaller won't
@ -352,15 +352,15 @@ public interface Marshaller {
"jaxb.fragment";
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into the specified
* <tt>javax.xml.transform.Result</tt>.
* Marshal the content tree rooted at {@code jaxbElement} into the specified
* {@code javax.xml.transform.Result}.
*
* <p>
* All JAXB Providers must at least support
* {@link javax.xml.transform.dom.DOMResult},
* {@link javax.xml.transform.sax.SAXResult}, and
* {@link javax.xml.transform.stream.StreamResult}. It can
* support other derived classes of <tt>Result</tt> as well.
* support other derived classes of {@code Result} as well.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@ -371,9 +371,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -382,7 +382,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into an output stream.
* Marshal the content tree rooted at {@code jaxbElement} into an output stream.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@ -393,9 +393,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -404,7 +404,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into a file.
* Marshal the content tree rooted at {@code jaxbElement} into a file.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@ -415,9 +415,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -427,7 +427,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into a Writer.
* Marshal the content tree rooted at {@code jaxbElement} into a Writer.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@ -438,9 +438,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -449,7 +449,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into SAX2 events.
* Marshal the content tree rooted at {@code jaxbElement} into SAX2 events.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@ -460,9 +460,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -471,7 +471,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into a DOM tree.
* Marshal the content tree rooted at {@code jaxbElement} into a DOM tree.
*
* @param jaxbElement
* The content tree to be marshalled.
@ -486,9 +486,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>jaxbElement</tt> (or any
* object reachable from <tt>jaxbElement</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
* object reachable from {@code jaxbElement}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -497,7 +497,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into a
* Marshal the content tree rooted at {@code jaxbElement} into a
* {@link javax.xml.stream.XMLStreamWriter}.
*
* @param jaxbElement
@ -509,9 +509,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -521,7 +521,7 @@ public interface Marshaller {
throws JAXBException;
/**
* Marshal the content tree rooted at <tt>jaxbElement</tt> into a
* Marshal the content tree rooted at {@code jaxbElement} into a
* {@link javax.xml.stream.XMLEventWriter}.
*
* @param jaxbElement
@ -533,9 +533,9 @@ public interface Marshaller {
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Marshaller</tt> is unable to marshal <tt>obj</tt> (or any
* object reachable from <tt>obj</tt>). See <a href="#elementMarshalling">
* returns false from its {@code handleEvent} method or the
* {@code Marshaller} is unable to marshal {@code obj} (or any
* object reachable from {@code obj}). See <a href="#elementMarshalling">
* Marshalling a JAXB element</a>.
* @throws IllegalArgumentException
* If any of the method parameters are null
@ -572,7 +572,7 @@ public interface Marshaller {
/**
* Set the particular property in the underlying implementation of
* <tt>Marshaller</tt>. This method can only be used to set one of
* {@code Marshaller}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">
@ -593,7 +593,7 @@ public interface Marshaller {
/**
* Get the particular property in the underlying implementation of
* <tt>Marshaller</tt>. This method can only be used to get one of
* {@code Marshaller}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">
@ -648,7 +648,7 @@ public interface Marshaller {
* Associates a configured instance of {@link XmlAdapter} with this marshaller.
*
* <p>
* This is a convenience method that invokes <code>setAdapter(adapter.getClass(),adapter);</code>.
* This is a convenience method that invokes {@code setAdapter(adapter.getClass(),adapter);}.
*
* @see #setAdapter(Class,XmlAdapter)
* @throws IllegalArgumentException
@ -724,7 +724,7 @@ public interface Marshaller {
* This method allows the caller to validate the marshalled XML as it's marshalled.
*
* <p>
* Initially this property is set to <tt>null</tt>.
* Initially this property is set to {@code null}.
*
* @param schema Schema object to validate marshal operations against or null to disable validation
* @throws UnsupportedOperationException could be thrown if this method is
@ -771,11 +771,11 @@ public interface Marshaller {
public static abstract class Listener {
/**
* <p>
* Callback method invoked before marshalling from <tt>source</tt> to XML.
* Callback method invoked before marshalling from {@code source} to XML.
* </p>
* <p>
* This method is invoked just before marshalling process starts to marshal <tt>source</tt>.
* Note that if the class of <tt>source</tt> defines its own <tt>beforeMarshal</tt> method,
* This method is invoked just before marshalling process starts to marshal {@code source}.
* Note that if the class of {@code source} defines its own {@code beforeMarshal} method,
* the class specific callback method is invoked just before this method is invoked.
*
* @param source instance of JAXB mapped class prior to marshalling from it.
@ -785,11 +785,11 @@ public interface Marshaller {
/**
* <p>
* Callback method invoked after marshalling <tt>source</tt> to XML.
* Callback method invoked after marshalling {@code source} to XML.
* </p>
* <p>
* This method is invoked after <tt>source</tt> and all its descendants have been marshalled.
* Note that if the class of <tt>source</tt> defines its own <tt>afterMarshal</tt> method,
* This method is invoked after {@code source} and all its descendants have been marshalled.
* Note that if the class of {@code source} defines its own {@code afterMarshal} method,
* the class specific callback method is invoked just before this method is invoked.
*
* @param source instance of JAXB mapped class after marshalling it.
@ -804,7 +804,7 @@ public interface Marshaller {
*
* <p>
* There is only one Listener per Marshaller. Setting a Listener replaces the previous set Listener.
* One can unregister current Listener by setting listener to <tt>null</tt>.
* One can unregister current Listener by setting listener to {@code null}.
*
* @param listener an instance of a class that implements {@link Listener}
* @since 1.6, JAXB 2.0
@ -814,7 +814,8 @@ 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.
* @return registered {@link Listener} or {@code null}
* if no Listener is registered with this Marshaller.
* @since 1.6, JAXB 2.0
*/
public Listener getListener();

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/TypeConstraintException.java
View File

@ -174,7 +174,7 @@ public class TypeConstraintException extends java.lang.RuntimeException {
/**
* Prints this TypeConstraintException and its stack trace (including the stack trace
* of the linkedException if it is non-null) to <tt>System.err</tt>.
* of the linkedException if it is non-null) to {@code System.err}.
*
*/
public void printStackTrace() {

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/UnmarshalException.java
View File

@ -31,7 +31,7 @@ package javax.xml.bind;
* the operation.
*
* <p>
* The <tt>ValidationEventHandler</tt> can cause this exception to be thrown
* The {@code ValidationEventHandler} can cause this exception to be thrown
* during the unmarshal operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.

212
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Unmarshaller.java
View File

@ -31,7 +31,7 @@ import javax.xml.validation.Schema;
import java.io.Reader;
/**
* The <tt>Unmarshaller</tt> class governs the process of deserializing XML
* The {@code Unmarshaller} class governs the process of deserializing XML
* data into newly created Java content trees, optionally validating the XML
* data as it is unmarshalled. It provides an overloading of unmarshal methods
* for many different input kinds.
@ -71,7 +71,7 @@ import java.io.Reader;
*
* <p>
* Unmarshalling from a StringBuffer using a
* <tt>javax.xml.transform.stream.StreamSource</tt>:
* {@code javax.xml.transform.stream.StreamSource}:
* <blockquote>
* <pre>{@code
* JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
@ -82,7 +82,7 @@ import java.io.Reader;
* </blockquote>
*
* <p>
* Unmarshalling from a <tt>org.w3c.dom.Node</tt>:
* Unmarshalling from a {@code org.w3c.dom.Node}:
* <blockquote>
* <pre>
* JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
@ -98,7 +98,7 @@ import java.io.Reader;
* </blockquote>
*
* <p>
* Unmarshalling from a <tt>javax.xml.transform.sax.SAXSource</tt> using a
* Unmarshalling from a {@code javax.xml.transform.sax.SAXSource} using a
* client specified validating SAX2.0 parser:
* <blockquote>
* <pre>
@ -205,17 +205,17 @@ import java.io.Reader;
* <a name="unmarshalGlobal"></a>
* <b>Unmarshal a root element that is globally declared</b><br>
* <blockquote>
* The unmarshal methods that do not have an <tt>declaredType</tt> parameter use
* The unmarshal methods that do not have an {@code declaredType} parameter use
* {@link JAXBContext} to unmarshal the root element of an XML data. The {@link JAXBContext}
* instance is the one that was used to create this <tt>Unmarshaller</tt>. The {@link JAXBContext}
* instance is the one that was used to create this {@code Unmarshaller}. The {@link JAXBContext}
* instance maintains a mapping of globally declared XML element and type definition names to
* JAXB mapped classes. The unmarshal method checks if {@link JAXBContext} has a mapping
* from the root element's XML name and/or <tt>@xsi:type</tt> to a JAXB mapped class. If it does, it umarshalls the
* from the root element's XML name and/or {@code @xsi:type} to a JAXB mapped class. If it does, it umarshalls the
* XML data using the appropriate JAXB mapped class. Note that when the root element name is unknown and the root
* element has an <tt>@xsi:type</tt>, the XML data is unmarshalled
* element has an {@code @xsi:type}, the XML data is unmarshalled
* using that JAXB mapped class as the value of a {@link JAXBElement}.
* When the {@link JAXBContext} object does not have a mapping for the root element's name
* nor its <tt>@xsi:type</tt>, if it exists,
* nor its {@code @xsi:type}, if it exists,
* then the unmarshal operation will abort immediately by throwing a {@link UnmarshalException
* UnmarshalException}. This exception scenario can be worked around by using the unmarshal by
* declaredType methods described in the next subsection.
@ -225,20 +225,20 @@ import java.io.Reader;
* <a name="unmarshalByDeclaredType"></a>
* <b>Unmarshal by Declared Type</b><br>
* <blockquote>
* The unmarshal methods with a <code>declaredType</code> parameter enable an
* The unmarshal methods with a {@code declaredType} parameter enable an
* application to deserialize a root element of XML data, even when
* there is no mapping in {@link JAXBContext} of the root element's XML name.
* The unmarshaller unmarshals the root element using the application provided
* mapping specified as the <tt>declaredType</tt> parameter.
* mapping specified as the {@code declaredType} parameter.
* Note that even when the root element's element name is mapped by {@link JAXBContext},
* the <code>declaredType</code> parameter overrides that mapping for
* the {@code declaredType} parameter overrides that mapping for
* deserializing the root element when using these unmarshal methods.
* Additionally, when the root element of XML data has an <tt>xsi:type</tt> attribute and
* Additionally, when the root element of XML data has an {@code xsi:type} attribute and
* that attribute's value references a type definition that is mapped
* to a JAXB mapped class by {@link JAXBContext}, that the root
* element's <tt>xsi:type</tt> attribute takes
* precedence over the unmarshal methods <tt>declaredType</tt> parameter.
* These methods always return a <tt>{@literal JAXBElement<declaredType>}</tt>
* element's {@code xsi:type} attribute takes
* precedence over the unmarshal methods {@code declaredType} parameter.
* These methods always return a {@code JAXBElement<declaredType>}
* instance. The table below shows how the properties of the returned JAXBElement
* instance are set.
*
@ -255,21 +255,21 @@ import java.io.Reader;
* </tr>
* <tr>
* <td>name</td>
* <td><code>xml element name</code></td>
* <td>{@code xml element name}</td>
* </tr>
* </thead>
* <tbody>
* <tr>
* <td>value</td>
* <td><code>instanceof declaredType</code></td>
* <td>{@code instanceof declaredType}</td>
* </tr>
* <tr>
* <td>declaredType</td>
* <td>unmarshal method <code>declaredType</code> parameter</td>
* <td>unmarshal method {@code declaredType} parameter</td>
* </tr>
* <tr>
* <td>scope</td>
* <td><code>null</code> <i>(actual scope is unknown)</i></td>
* <td>{@code null} <i>(actual scope is unknown)</i></td>
* </tr>
* </tbody>
* </table>
@ -279,7 +279,7 @@ import java.io.Reader;
* The following is an example of
* <a href="#unmarshalByDeclaredType">unmarshal by declaredType method</a>.
* <p>
* Unmarshal by declaredType from a <tt>org.w3c.dom.Node</tt>:
* Unmarshal by declaredType from a {@code org.w3c.dom.Node}:
* <blockquote>
* <pre>{@code
* Schema fragment for example
@ -330,7 +330,7 @@ import java.io.Reader;
* <blockquote>
* <p>
* A client application can enable or disable JAXP 1.3 validation
* mechanism via the <tt>setSchema(javax.xml.validation.Schema)</tt> API.
* mechanism via the {@code setSchema(javax.xml.validation.Schema)} API.
* Sophisticated clients can specify their own validating SAX 2.0 compliant
* parser and bypass the JAXP 1.3 validation mechanism using the
* {@link #unmarshal(javax.xml.transform.Source) unmarshal(Source)} API.
@ -421,8 +421,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the file parameter is null
@ -444,8 +444,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the InputStream parameter is null
@ -468,8 +468,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the InputStream parameter is null
@ -491,8 +491,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the URL parameter is null
@ -513,8 +513,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the InputSource parameter is null
@ -537,8 +537,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the Node parameter is null
@ -547,7 +547,7 @@ public interface Unmarshaller {
public Object unmarshal( org.w3c.dom.Node node ) throws JAXBException;
/**
* Unmarshal XML data by JAXB mapped <tt>declaredType</tt>
* Unmarshal XML data by JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
* <p>
@ -557,16 +557,16 @@ public interface Unmarshaller {
* the document/element to unmarshal XML data from.
* The caller must support at least Document and Element.
* @param declaredType
* appropriate JAXB mapped class to hold <tt>node</tt>'s XML data.
* appropriate JAXB mapped class to hold {@code node}'s XML data.
*
* @return <a href="#unmarshalDeclaredTypeReturn">JAXB Element</a> representation of <tt>node</tt>
* @return <a href="#unmarshalDeclaredTypeReturn">JAXB Element</a> representation of {@code node}
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
@ -588,30 +588,30 @@ public interface Unmarshaller {
* A client application can choose not to use the default parser mechanism
* supplied with their JAXB provider. Any SAX 2.0 compliant parser can be
* substituted for the JAXB provider's default mechanism. To do so, the
* client application must properly configure a <tt>SAXSource</tt> containing
* an <tt>XMLReader</tt> implemented by the SAX 2.0 parser provider. If the
* <tt>XMLReader</tt> has an <tt>org.xml.sax.ErrorHandler</tt> registered
* client application must properly configure a {@code SAXSource} containing
* an {@code XMLReader} implemented by the SAX 2.0 parser provider. If the
* {@code XMLReader} has an {@code org.xml.sax.ErrorHandler} registered
* on it, it will be replaced by the JAXB Provider so that validation errors
* can be reported via the <tt>ValidationEventHandler</tt> mechanism of
* JAXB. If the <tt>SAXSource</tt> does not contain an <tt>XMLReader</tt>,
* can be reported via the {@code ValidationEventHandler} mechanism of
* JAXB. If the {@code SAXSource} does not contain an {@code XMLReader},
* then the JAXB provider's default parser mechanism will be used.
* <p>
* This parser replacement mechanism can also be used to replace the JAXB
* provider's unmarshal-time validation engine. The client application
* must properly configure their SAX 2.0 compliant parser to perform
* validation (as shown in the example above). Any <tt>SAXParserExceptions
* </tt> encountered by the parser during the unmarshal operation will be
* validation (as shown in the example above). Any {@code SAXParserExceptions}
* encountered by the parser during the unmarshal operation will be
* processed by the JAXB provider and converted into JAXB
* <tt>ValidationEvent</tt> objects which will be reported back to the
* client via the <tt>ValidationEventHandler</tt> registered with the
* <tt>Unmarshaller</tt>. <i>Note:</i> specifying a substitute validating
* {@code ValidationEvent} objects which will be reported back to the
* client via the {@code ValidationEventHandler} registered with the
* {@code Unmarshaller}. <i>Note:</i> specifying a substitute validating
* SAX 2.0 parser for unmarshalling does not necessarily replace the
* validation engine used by the JAXB provider for performing on-demand
* validation.
* <p>
* The only way for a client application to specify an alternate parser
* mechanism to be used during unmarshal is via the
* <tt>unmarshal(SAXSource)</tt> API. All other forms of the unmarshal
* {@code unmarshal(SAXSource)} API. All other forms of the unmarshal
* method (File, URL, Node, etc) will use the JAXB provider's default
* parser and validator mechanisms.
*
@ -623,8 +623,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the Source parameter is null
@ -635,7 +635,7 @@ public interface Unmarshaller {
/**
* Unmarshal XML data from the specified XML Source by <tt>declaredType</tt> and return the
* Unmarshal XML data from the specified XML Source by {@code declaredType} and return the
* resulting content tree.
*
* <p>
@ -647,15 +647,15 @@ public interface Unmarshaller {
* @param source the XML Source to unmarshal XML data from (providers are
* only required to support SAXSource, DOMSource, and StreamSource)
* @param declaredType
* appropriate JAXB mapped class to hold <tt>source</tt>'s xml root element
* appropriate JAXB mapped class to hold {@code source}'s xml root element
* @return Java content rooted by <a href="#unmarshalDeclaredTypeReturn">JAXB Element</a>
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
@ -675,7 +675,7 @@ public interface Unmarshaller {
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
* returns successfully, the <tt>reader</tt> will be pointing at
* returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
@ -687,13 +687,13 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the <tt>reader</tt> parameter is null
* If the {@code reader} parameter is null
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* If {@code reader} is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLStreamReader, Class)
@ -702,7 +702,7 @@ public interface Unmarshaller {
throws JAXBException;
/**
* Unmarshal root element to JAXB mapped <tt>declaredType</tt>
* Unmarshal root element to JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
* <p>
@ -711,13 +711,13 @@ public interface Unmarshaller {
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
* returns successfully, the <tt>reader</tt> will be pointing at
* returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
* The parser to be read.
* @param declaredType
* appropriate JAXB mapped class to hold <tt>reader</tt>'s START_ELEMENT XML data.
* appropriate JAXB mapped class to hold {@code reader}'s START_ELEMENT XML data.
*
* @return content tree rooted by <a href="#unmarshalDeclaredTypeReturn">JAXB Element representation</a>
*
@ -725,8 +725,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
@ -745,7 +745,7 @@ public interface Unmarshaller {
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
* returns successfully, the <tt>reader</tt> will be pointing at
* returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
@ -757,13 +757,13 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If the <tt>reader</tt> parameter is null
* If the {@code reader} parameter is null
* @throws IllegalStateException
* If <tt>reader</tt> is not pointing to a START_DOCUMENT or
* If {@code reader} is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLEventReader, Class)
@ -772,7 +772,7 @@ public interface Unmarshaller {
throws JAXBException;
/**
* Unmarshal root element to JAXB mapped <tt>declaredType</tt>
* Unmarshal root element to JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
* <p>
@ -782,13 +782,13 @@ public interface Unmarshaller {
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
* returns successfully, the <tt>reader</tt> will be pointing at
* returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
* The parser to be read.
* @param declaredType
* appropriate JAXB mapped class to hold <tt>reader</tt>'s START_ELEMENT XML data.
* appropriate JAXB mapped class to hold {@code reader}'s START_ELEMENT XML data.
*
* @return content tree rooted by <a href="#unmarshalDeclaredTypeReturn">JAXB Element representation</a>
*
@ -796,8 +796,8 @@ public interface Unmarshaller {
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Unmarshaller</tt> is unable to perform the XML to Java
* returns false from its {@code handleEvent} method or the
* {@code Unmarshaller} is unable to perform the XML to Java
* binding. See <a href="#unmarshalEx">Unmarshalling XML Data</a>
* @throws IllegalArgumentException
* If any parameter is null
@ -812,9 +812,9 @@ public interface Unmarshaller {
* <p>
* The JAXB Provider can return the same handler object for multiple
* invocations of this method. In other words, this method does not
* necessarily create a new instance of <tt>UnmarshallerHandler</tt>. If the
* application needs to use more than one <tt>UnmarshallerHandler</tt>, it
* should create more than one <tt>Unmarshaller</tt>.
* necessarily create a new instance of {@code UnmarshallerHandler}. If the
* application needs to use more than one {@code UnmarshallerHandler}, it
* should create more than one {@code Unmarshaller}.
*
* @return the unmarshaller handler object
* @see UnmarshallerHandler
@ -823,8 +823,8 @@ public interface Unmarshaller {
/**
* Specifies whether or not the default validation mechanism of the
* <tt>Unmarshaller</tt> should validate during unmarshal operations.
* By default, the <tt>Unmarshaller</tt> does not validate.
* {@code Unmarshaller} should validate during unmarshal operations.
* By default, the {@code Unmarshaller} does not validate.
* <p>
* This method may only be invoked before or after calling one of the
* unmarshal methods.
@ -852,7 +852,7 @@ public interface Unmarshaller {
throws JAXBException;
/**
* Indicates whether or not the <tt>Unmarshaller</tt> is configured to
* Indicates whether or not the {@code Unmarshaller} is configured to
* validate during unmarshal operations.
* <p>
* This API returns the state of the JAXB Provider's default unmarshal-time
@ -874,13 +874,13 @@ public interface Unmarshaller {
throws JAXBException;
/**
* Allow an application to register a <tt>ValidationEventHandler</tt>.
* Allow an application to register a {@code ValidationEventHandler}.
* <p>
* The <tt>ValidationEventHandler</tt> will be called by the JAXB Provider
* The {@code ValidationEventHandler} will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* unmarshal methods. If the client application does not register a
* <tt>ValidationEventHandler</tt> before invoking the unmarshal methods,
* then <tt>ValidationEvents</tt> will be handled by the default event
* {@code ValidationEventHandler} before invoking the unmarshal methods,
* then {@code ValidationEvents} will be handled by the default event
* handler which will terminate the unmarshal operation after the first
* error or fatal error is encountered.
* <p>
@ -908,7 +908,7 @@ public interface Unmarshaller {
/**
* Set the particular property in the underlying implementation of
* <tt>Unmarshaller</tt>. This method can only be used to set one of
* {@code Unmarshaller}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">
@ -929,7 +929,7 @@ public interface Unmarshaller {
/**
* Get the particular property in the underlying implementation of
* <tt>Unmarshaller</tt>. This method can only be used to get one of
* {@code Unmarshaller}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">
@ -955,7 +955,7 @@ public interface Unmarshaller {
* API.
*
* <p>
* Initially this property is set to <tt>null</tt>.
* Initially this property is set to {@code null}.
*
* @param schema Schema object to validate unmarshal operations against or null to disable validation
* @throws UnsupportedOperationException could be thrown if this method is
@ -976,9 +976,9 @@ public interface Unmarshaller {
* To determine if the Unmarshaller has validation enabled, simply
* test the return type for null:
* <p>
* <code>
* <pre>{@code
* boolean isValidating = u.getSchema()!=null;
* </code>
* }</pre>
*
* @return the Schema object being used to perform unmarshal-time
* validation or null if not present
@ -993,7 +993,7 @@ public interface Unmarshaller {
* Associates a configured instance of {@link XmlAdapter} with this unmarshaller.
*
* <p>
* This is a convenience method that invokes <code>setAdapter(adapter.getClass(),adapter);</code>.
* This is a convenience method that invokes {@code setAdapter(adapter.getClass(),adapter);}.
*
* @see #setAdapter(Class,XmlAdapter)
* @throws IllegalArgumentException
@ -1084,34 +1084,35 @@ public interface Unmarshaller {
public static abstract class Listener {
/**
* <p>
* Callback method invoked before unmarshalling into <tt>target</tt>.
* Callback method invoked before unmarshalling into {@code target}.
* </p>
* <p>
* This method is invoked immediately after <tt>target</tt> was created and
* This method is invoked immediately after {@code target} was created and
* before the unmarshalling of this object begins. Note that
* if the class of <tt>target</tt> defines its own <tt>beforeUnmarshal</tt> method,
* if the class of {@code target} defines its own {@code beforeUnmarshal} method,
* the class specific callback method is invoked before this method is invoked.
*
* @param target non-null instance of JAXB mapped class prior to unmarshalling into it.
* @param parent instance of JAXB mapped class that will eventually reference <tt>target</tt>.
* <tt>null</tt> when <tt>target</tt> is root element.
* @param parent instance of JAXB mapped class that will eventually reference {@code target}.
* {@code null} when {@code target} is root element.
*/
public void beforeUnmarshal(Object target, Object parent) {
}
/**
* <p>
* Callback method invoked after unmarshalling XML data into <tt>target</tt>.
* Callback method invoked after unmarshalling XML data into {@code target}.
* </p>
* <p>
* This method is invoked after all the properties (except IDREF) are unmarshalled into <tt>target</tt>,
* but before <tt>target</tt> is set into its <tt>parent</tt> object.
* Note that if the class of <tt>target</tt> defines its own <tt>afterUnmarshal</tt> method,
* This method is invoked after all the properties (except IDREF)
* are unmarshalled into {@code target},
* but before {@code target} is set into its {@code parent} object.
* Note that if the class of {@code target} defines its own {@code afterUnmarshal} method,
* the class specific callback method is invoked before this method is invoked.
*
* @param target non-null instance of JAXB mapped class prior to unmarshalling into it.
* @param parent instance of JAXB mapped class that will reference <tt>target</tt>.
* <tt>null</tt> when <tt>target</tt> is root element.
* @param parent instance of JAXB mapped class that will reference {@code target}.
* {@code null} when {@code target} is root element.
*/
public void afterUnmarshal(Object target, Object parent) {
}
@ -1123,7 +1124,7 @@ public interface Unmarshaller {
*
* <p>
* There is only one Listener per Unmarshaller. Setting a Listener replaces the previous set Listener.
* One can unregister current Listener by setting listener to <tt>null</tt>.
* One can unregister current Listener by setting listener to {@code null}.
*
* @param listener provides unmarshal event callbacks for this {@link Unmarshaller}
* @since 1.6, JAXB 2.0
@ -1133,7 +1134,8 @@ 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.
* @return registered {@link Listener} or {@code null}
* if no Listener is registered with this Unmarshaller.
* @since 1.6, JAXB 2.0
*/
public Listener getListener();

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEvent.java
View File

@ -60,8 +60,8 @@ public interface ValidationEvent {
* Retrieve the severity code for this warning/error.
*
* <p>
* Must be one of <tt>ValidationError.WARNING</tt>,
* <tt>ValidationError.ERROR</tt>, or <tt>ValidationError.FATAL_ERROR</tt>.
* Must be one of {@code ValidationError.WARNING},
* {@code ValidationError.ERROR}, or {@code ValidationError.FATAL_ERROR}.
*
* @return the severity code for this warning/error
*/

12
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventHandler.java
View File

@ -39,7 +39,7 @@ package javax.xml.bind;
* handlers.
*
* <p>
* If the <tt>handleEvent</tt> method throws an unchecked runtime exception,
* If the {@code handleEvent} method throws an unchecked runtime exception,
* the JAXB Provider must treat that as if the method returned false, effectively
* terminating whatever operation was in progress at the time (unmarshal,
* validate, or marshal).
@ -49,7 +49,7 @@ package javax.xml.bind;
* by the specification and may result in unexpected behaviour.
*
* <p>
* Failing to return false from the <tt>handleEvent</tt> method after
* Failing to return false from the {@code handleEvent} method after
* encountering a fatal error is undefined by the specification and may result
* in unexpected behavior.
*
@ -59,7 +59,9 @@ package javax.xml.bind;
* See: <a href="Validator.html#defaulthandler">Validator javadocs</a>
* </blockquote>
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @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 Unmarshaller
* @see Validator
* @see Marshaller
@ -85,8 +87,8 @@ public interface ValidationEventHandler {
* @return true if the JAXB Provider should attempt to continue the current
* unmarshal, validate, or marshal operation after handling this
* warning/error, false if the provider should terminate the current
* operation with the appropriate <tt>UnmarshalException</tt>,
* <tt>ValidationException</tt>, or <tt>MarshalException</tt>.
* operation with the appropriate {@code UnmarshalException},
* {@code ValidationException}, or {@code MarshalException}.
* @throws IllegalArgumentException if the event object is null.
*/
public boolean handleEvent( ValidationEvent event );

8
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventLocator.java
View File

@ -29,15 +29,17 @@ package javax.xml.bind;
* Encapsulate the location of a ValidationEvent.
*
* <p>
* The <tt>ValidationEventLocator</tt> indicates where the <tt>ValidationEvent
* </tt> occurred. Different fields will be set depending on the type of
* The {@code ValidationEventLocator} indicates where the {@code ValidationEvent}
* occurred. Different fields will be set depending on the type of
* validation that was being performed when the error or warning was detected.
* For example, on-demand validation would produce locators that contained
* references to objects in the Java content tree while unmarshal-time
* validation would produce locators containing information appropriate to the
* source of the XML data (file, url, Node, etc).
*
* @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li><li>Kohsuke Kawaguchi, Sun Microsystems, Inc.</li><li>Joe Fialli, Sun Microsystems, Inc.</li></ul>
* @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 1.6, JAXB 1.0

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/ValidationException.java
View File

@ -30,7 +30,7 @@ package javax.xml.bind;
* a validate operation.
*
* <p>
* The <tt>ValidationEventHandler</tt> can cause this exception to be thrown
* The {@code ValidationEventHandler} can cause this exception to be thrown
* during the validate operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.

54
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/Validator.java
View File

@ -28,7 +28,7 @@ package javax.xml.bind;
/**
* As of JAXB 2.0, this class is deprecated and optional.
* <p>
* The <tt>Validator</tt> class is responsible for controlling the validation
* The {@code Validator} class is responsible for controlling the validation
* of content trees during runtime.
*
* <p>
@ -69,19 +69,19 @@ package javax.xml.bind;
* </blockquote>
*
* <p>
* The <tt>Validator</tt> class is responsible for managing On-Demand Validation.
* The <tt>Unmarshaller</tt> class is responsible for managing Unmarshal-Time
* The {@code Validator} class is responsible for managing On-Demand Validation.
* The {@code Unmarshaller} class is responsible for managing Unmarshal-Time
* Validation during the unmarshal operations. Although there is no formal
* method of enabling validation during the marshal operations, the
* <tt>Marshaller</tt> may detect errors, which will be reported to the
* <tt>ValidationEventHandler</tt> registered on it.
* {@code Marshaller} may detect errors, which will be reported to the
* {@code ValidationEventHandler} registered on it.
*
* <p>
* <a name="defaulthandler"></a>
* <b>Using the Default EventHandler</b><br>
* <blockquote>
* If the client application does not set an event handler on their
* <tt>Validator</tt>, <tt>Unmarshaller</tt>, or <tt>Marshaller</tt> prior to
* {@code Validator}, {@code Unmarshaller}, or {@code Marshaller} prior to
* calling the validate, unmarshal, or marshal methods, then a default event
* handler will receive notification of any errors or warnings encountered.
* The default event handler will cause the current operation to halt after
@ -98,24 +98,24 @@ package javax.xml.bind;
* <dl>
* <dt>Use the default event handler</dt>
* <dd>The default event handler will be used if you do not specify one
* via the <tt>setEventHandler</tt> API's on <tt>Validator</tt>,
* <tt>Unmarshaller</tt>, or <tt>Marshaller</tt>.
* via the {@code setEventHandler} API's on {@code Validator},
* {@code Unmarshaller}, or {@code Marshaller}.
* </dd>
*
* <dt>Implement and register a custom event handler</dt>
* <dd>Client applications that require sophisticated event processing
* can implement the <tt>ValidationEventHandler</tt> interface and
* register it with the <tt>Unmarshaller</tt> and/or
* <tt>Validator</tt>.
* can implement the {@code ValidationEventHandler} interface and
* register it with the {@code Unmarshaller} and/or
* {@code Validator}.
* </dd>
*
* <dt>Use the {@link javax.xml.bind.util.ValidationEventCollector ValidationEventCollector}
* utility</dt>
* <dd>For convenience, a specialized event handler is provided that
* simply collects any <tt>ValidationEvent</tt> objects created
* simply collects any {@code ValidationEvent} objects created
* during the unmarshal, validate, and marshal operations and
* returns them to the client application as a
* <tt>java.util.Collection</tt>.
* {@code java.util.Collection}.
* </dd>
* </dl>
* </blockquote>
@ -131,9 +131,9 @@ package javax.xml.bind;
* cases, the JAXB Provider will set the severity of the ValidationEvent to
* FATAL_ERROR to indicate that the unmarshal, validate, or marshal operations
* should be terminated. The default event handler and
* <tt>ValidationEventCollector</tt> utility class must terminate processing
* {@code ValidationEventCollector} utility class must terminate processing
* after being notified of a fatal error. Client applications that supply their
* own <tt>ValidationEventHandler</tt> should also terminate processing after
* own {@code ValidationEventHandler} should also terminate processing after
* being notified of a fatal error. If not, unexpected behaviour may occur.
* </blockquote>
*
@ -195,7 +195,7 @@ public interface Validator {
throws JAXBException;
/**
* Validate the Java content tree starting at <tt>subrootObj</tt>.
* Validate the Java content tree starting at {@code subrootObj}.
* <p>
* Client applications can use this method to validate Java content trees
* on-demand at runtime. This method can be used to validate any arbitrary
@ -206,19 +206,19 @@ public interface Validator {
* @throws JAXBException if any unexpected problem occurs during validation
* @throws ValidationException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Validator</tt> is unable to validate the content tree rooted
* at <tt>subrootObj</tt>
* returns false from its {@code handleEvent} method or the
* {@code Validator} is unable to validate the content tree rooted
* at {@code subrootObj}
* @throws IllegalArgumentException
* If the subrootObj parameter is null
* @return true if the subtree rooted at <tt>subrootObj</tt> is valid, false
* @return true if the subtree rooted at {@code subrootObj} is valid, false
* otherwise
* @deprecated since JAXB2.0
*/
public boolean validate( Object subrootObj ) throws JAXBException;
/**
* Validate the Java content tree rooted at <tt>rootObj</tt>.
* Validate the Java content tree rooted at {@code rootObj}.
* <p>
* Client applications can use this method to validate Java content trees
* on-demand at runtime. This method is used to validate an entire Java
@ -229,12 +229,12 @@ public interface Validator {
* @throws JAXBException if any unexpected problem occurs during validation
* @throws ValidationException
* If the {@link ValidationEventHandler ValidationEventHandler}
* returns false from its <tt>handleEvent</tt> method or the
* <tt>Validator</tt> is unable to validate the content tree rooted
* at <tt>rootObj</tt>
* returns false from its {@code handleEvent} method or the
* {@code Validator} is unable to validate the content tree rooted
* at {@code rootObj}
* @throws IllegalArgumentException
* If the rootObj parameter is null
* @return true if the tree rooted at <tt>rootObj</tt> is valid, false
* @return true if the tree rooted at {@code rootObj} is valid, false
* otherwise
* @deprecated since JAXB2.0
*/
@ -242,7 +242,7 @@ public interface Validator {
/**
* Set the particular property in the underlying implementation of
* <tt>Validator</tt>. This method can only be used to set one of
* {@code Validator}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">
@ -264,7 +264,7 @@ public interface Validator {
/**
* Get the particular property in the underlying implementation of
* <tt>Validator</tt>. This method can only be used to get one of
* {@code Validator}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See <a href="#supportedProps">

10
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorOrder.java
View File

@ -38,7 +38,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <h3>Usage </h3>
*
* <p> <tt> @XmlAccessorOrder </tt> annotation can be used with the following
* <p> {@code @XmlAccessorOrder} annotation can be used with the following
* program elements:</p>
*
* <ul>
@ -46,19 +46,19 @@ import static java.lang.annotation.RetentionPolicy.*;
* <li> a top level class </li>
* </ul>
*
* <p> See "Package Specification" in <tt>javax.xml.bind</tt> package javadoc for
* <p> See "Package Specification" in {@code javax.xml.bind} package javadoc for
* additional common information.</p>
*
* <p>The effective {@link XmlAccessOrder} on a class is determined
* as follows:
*
* <ul>
* <li> If there is a <tt>@XmlAccessorOrder</tt> on a class, then
* <li> If there is a {@code @XmlAccessorOrder} on a class, then
* it is used. </li>
* <li> Otherwise, if a <tt>@XmlAccessorOrder </tt> exists on one of
* <li> Otherwise, if a {@code @XmlAccessorOrder} exists on one of
* its super classes, then it is inherited (by the virtue of
* {@link Inherited})
* <li> Otherwise, the <tt>@XmlAccessorOrder</tt> on the package
* <li> Otherwise, the {@code @XmlAccessorOrder} on the package
* of the class is used, if it's there.
* <li> Otherwise {@link XmlAccessOrder#UNDEFINED}.
* </ul>

16
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorType.java
View File

@ -38,7 +38,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <p> <b> Usage </b> </p>
*
* <p> <tt>@XmlAccessorType</tt> annotation can be used with the following program elements:</p>
* <p> {@code @XmlAccessorType} annotation can be used with the following program elements:</p>
*
* <ul>
* <li> package</li>
@ -51,28 +51,28 @@ import static java.lang.annotation.RetentionPolicy.*;
* <p>This annotation provides control over the default serialization
* of properties and fields in a class.
*
* <p>The annotation <tt> @XmlAccessorType </tt> on a package applies to
* <p>The annotation {@code @XmlAccessorType} on a package applies to
* all classes in the package. The following inheritance
* semantics apply:
*
* <ul>
* <li> If there is a <tt>@XmlAccessorType</tt> on a class, then it
* <li> If there is a {@code @XmlAccessorType} on a class, then it
* is used. </li>
* <li> Otherwise, if a <tt>@XmlAccessorType</tt> exists on one of
* <li> Otherwise, if a {@code @XmlAccessorType} exists on one of
* its super classes, then it is inherited.
* <li> Otherwise, the <tt>@XmlAccessorType </tt> on a package is
* <li> Otherwise, the {@code @XmlAccessorType} on a package is
* inherited.
* </ul>
* <p> <b> Defaulting Rules: </b> </p>
*
* <p>By default, if <tt>@XmlAccessorType </tt> on a package is absent,
* <p>By default, if {@code @XmlAccessorType} on a package is absent,
* then the following package level annotation is assumed.</p>
* <pre>
* &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
* </pre>
* <p> By default, if <tt>@XmlAccessorType</tt> on a class is absent,
* <p> By default, if {@code @XmlAccessorType} on a class is absent,
* and none of its super classes is annotated with
* <tt>@XmlAccessorType</tt>, then the following default on the class
* {@code @XmlAccessorType}, then the following default on the class
* is assumed: </p>
* <pre>
* &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAnyAttribute.java
View File

@ -40,7 +40,7 @@ import static java.lang.annotation.ElementType.METHOD;
*
* <p> <b>Usage</b> </p>
* <p>
* The <tt>&#64;XmlAnyAttribute</tt> annotation can be used with the
* The {@code @XmlAnyAttribute} annotation can be used with the
* following program elements:
* <ul>
* <li> JavaBean property </li>
@ -53,8 +53,8 @@ import static java.lang.annotation.ElementType.METHOD;
* The usage is subject to the following constraints:
* <ul>
* <li> At most one field or property in a class can be annotated
* with <tt>&#64;XmlAnyAttribute</tt>. </li>
* <li> The type of the property or the field must <tt>java.util.Map</tt> </li>
* with {@code @XmlAnyAttribute}. </li>
* <li> The type of the property or the field must {@code java.util.Map} </li>
* </ul>
*
* <p>

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAttribute.java
View File

@ -37,7 +37,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <p> <b>Usage</b> </p>
* <p>
* The <tt>@XmlAttribute</tt> annotation can be used with the
* The {@code @XmlAttribute} annotation can be used with the
* following program elements:
* <ul>
* <li> JavaBean property </li>

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java
View File

@ -38,7 +38,7 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <p> <b>Usage</b>
* <p>
* <tt>@XmlElement</tt> annotation can be used with the following program
* {@code @XmlElement} annotation can be used with the following program
* elements:
* <ul>
* <li> a JavaBean property </li>
@ -62,7 +62,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* <li> if the type of JavaBean property is a collection type of
* array, an indexed property, or a parameterized list, and
* this annotation is used with {@link XmlElements} then,
* <tt>@XmlElement.type()</tt> must be DEFAULT.class since the
* {@code @XmlElement.type()} must be DEFAULT.class since the
* collection item type is already known. </li>
* </ul>
*

10
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementDecl.java
View File

@ -170,19 +170,19 @@ public @interface XmlElementDecl {
* namespace name of a substitution group's head XML element.
* <p>
* This specifies the namespace name of the XML element whose local
* name is specified by <tt>substitutionHeadName()</tt>.
* name is specified by {@code substitutionHeadName()}.
* <p>
* If <tt>susbtitutionHeadName()</tt> is "", then this
* If {@code susbtitutionHeadName()} is "", then this
* value can only be "##default". But the value is ignored since
* since this element is not part of susbtitution group when the
* value of <tt>susbstitutionHeadName()</tt> is "".
* value of {@code susbstitutionHeadName()} is "".
* <p>
* If <tt>susbtitutionHeadName()</tt> is not "" and the value is
* If {@code susbtitutionHeadName()} is not "" and the value is
* "##default", then the namespace name is the namespace name to
* which the package of the containing class, marked with {@link
* XmlRegistry }, is mapped.
* <p>
* If <tt>susbtitutionHeadName()</tt> is not "" and the value is
* If {@code susbtitutionHeadName()} is not "" and the value is
* not "##default", then the value is the namespace name.
*
* @see #substitutionHeadName()

22
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementRef.java
View File

@ -39,7 +39,7 @@ import static java.lang.annotation.ElementType.METHOD;
* <p>
* <b>Usage</b>
* <p>
* <tt>&#64;XmlElementRef</tt> annotation can be used with a
* {@code @XmlElementRef} annotation can be used with a
* JavaBean property or from within {@link XmlElementRefs}
* <p>
* This annotation dynamically associates an XML element name with the JavaBean
@ -62,9 +62,9 @@ import static java.lang.annotation.ElementType.METHOD;
* }</pre>
* <p>
* An element factory method annotated with {@link XmlElementDecl} is
* used to create a <tt>JAXBElement</tt> instance, containing an XML
* element name. The presence of &#64;XmlElementRef annotation on an
* element property indicates that the element name from <tt>JAXBElement</tt>
* used to create a {@code JAXBElement} instance, containing an XML
* element name. The presence of {@code @XmlElementRef} annotation on an
* element property indicates that the element name from {@code JAXBElement}
* instance be used instead of deriving an XML element name from the
* JavaBean property name.
*
@ -74,7 +74,7 @@ import static java.lang.annotation.ElementType.METHOD;
* <li> If the collection item type (for collection property) or
* property type (for single valued property) is
* {@link javax.xml.bind.JAXBElement}, then
* <tt>&#64;XmlElementRef}.name()</tt> and <tt>&#64;XmlElementRef.namespace()</tt> must
* {@code @XmlElementRef.name()} and {@code @XmlElementRef.namespace()} must
* point an element factory method with an @XmlElementDecl
* annotation in a class annotated with @XmlRegistry (usually
* ObjectFactory class generated by the schema compiler) :
@ -155,7 +155,7 @@ import static java.lang.annotation.ElementType.METHOD;
* </target>
* }</pre>
* <p>
* It is not an error to have a class that extends <tt>Task</tt>
* It is not an error to have a class that extends {@code Task}
* that doesn't have {@link XmlRootElement}. But they can't show up in an
* XML instance (because they don't have XML element names).
*
@ -234,8 +234,8 @@ public @interface XmlElementRef {
* This parameter and {@link #name()} are used to determine the
* XML element for the JavaBean property.
*
* <p> If <tt>type()</tt> is <tt>JAXBElement.class</tt> , then
* <tt>namespace()</tt> and <tt>name()</tt>
* <p> If {@code type()} is {@code JAXBElement.class} , then
* {@code namespace()} and {@code name()}
* point to a factory method with {@link XmlElementDecl}. The XML
* element name is the element name from the factory method's
* {@link XmlElementDecl} annotation or if an element from its
@ -243,13 +243,13 @@ public @interface XmlElementRef {
* substituted in the XML document, then the element name is from the
* {@link XmlElementDecl} on the substituted element.
*
* <p> If {@link #type()} is not <tt>JAXBElement.class</tt>, then
* <p> If {@link #type()} is not {@code JAXBElement.class}, then
* the XML element name is the XML element name statically
* associated with the type using the annotation {@link
* XmlRootElement} on the type. If the type is not annotated with
* an {@link XmlElementDecl}, then it is an error.
*
* <p> If <tt>type()</tt> is not <tt>JAXBElement.class</tt>, then
* <p> If {@code type()} is not {@code JAXBElement.class}, then
* this value must be "".
*
*/
@ -282,7 +282,7 @@ public @interface XmlElementRef {
* for a multivalued property.
*
* <p>
* For compatibility with JAXB 2.1, this property defaults to <tt>true</tt>,
* For compatibility with JAXB 2.1, this property defaults to {@code true},
* despite the fact that {@link XmlElement#required()} defaults to false.
*
* @since 1.7, JAXB 2.2

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementWrapper.java
View File

@ -61,7 +61,7 @@ import java.lang.annotation.Target;
*
* <p> <b>Usage</b> </p>
* <p>
* The <tt>@XmlElementWrapper</tt> annotation can be used with the
* The {@code @XmlElementWrapper} annotation can be used with the
* following program elements:
* <ul>
* <li> JavaBean property </li>
@ -120,7 +120,7 @@ public @interface XmlElementWrapper {
/**
* If true, the absence of the collection is represented by
* using <tt>xsi:nil='true'</tt>. Otherwise, it is represented by
* using {@code xsi:nil='true'}. Otherwise, it is represented by
* the absence of the element.
*/
boolean nillable() default false;
@ -130,7 +130,7 @@ public @interface XmlElementWrapper {
*
* <p>
* If required() is true, then the corresponding generated
* XML schema element declaration will have <tt>minOccurs="1"</tt>,
* XML schema element declaration will have {@code minOccurs="1"},
* to indicate that the wrapper element is always expected.
*
* <p>

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElements.java
View File

@ -44,7 +44,7 @@ import java.lang.annotation.Target;
* &#64;XmlElements({ @XmlElement(...),@XmlElement(...) })
* </pre>
*
* <p>The <tt>@XmlElements</tt> annotation can be used with the
* <p>The {@code @XmlElements} annotation can be used with the
* following program elements: </p>
* <ul>
* <li> a JavaBean property </li>
@ -62,7 +62,7 @@ import java.lang.annotation.Target;
* annotations: @{@link XmlIDREF}, @{@link XmlElementWrapper}. </li>
* <li> If @XmlIDREF is also specified on the JavaBean property,
* then each &#64;XmlElement.type() must contain a JavaBean
* property annotated with <tt>&#64;XmlID</tt>.</li>
* property annotated with {@code @XmlID}.</li>
* </ul>
*
* <p>See "Package Specification" in javax.xml.bind.package javadoc for

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnum.java
View File

@ -39,7 +39,7 @@ import java.lang.annotation.Target;
*
* <p> <b>Usage</b> </p>
* <p>
* The <tt>@XmlEnum</tt> annotation can be used with the
* The {@code @XmlEnum} annotation can be used with the
* following program elements:
* <ul>
* <li>enum type</li>
@ -56,9 +56,9 @@ import java.lang.annotation.Target;
*
* <p>An enum type is mapped to a schema simple type with enumeration
* facets. The schema type is derived from the Java type to which
* <tt>@XmlEnum.value()</tt>. Each enum constant <tt>@XmlEnumValue</tt>
* {@code @XmlEnum.value()}. Each enum constant {@code @XmlEnumValue}
* must have a valid lexical representation for the type
* <tt>@XmlEnum.value()</tt> .
* {@code @XmlEnum.value()}.
*
* <p><b>Examples:</b> See examples in {@link XmlEnumValue}
*

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnumValue.java
View File

@ -35,7 +35,7 @@ import static java.lang.annotation.ElementType.FIELD;
*
* <p> <b>Usage</b> </p>
*
* <p> The <tt>@XmlEnumValue</tt> annotation can be used with the
* <p> The {@code @XmlEnumValue} annotation can be used with the
* following program elements:
* <ul>
* <li>enum constant</li>
@ -49,9 +49,9 @@ import static java.lang.annotation.ElementType.FIELD;
*
* <p>An enum type is mapped to a schema simple type with enumeration
* facets. The schema type is derived from the Java type specified in
* <tt>@XmlEnum.value()</tt>. Each enum constant <tt>@XmlEnumValue</tt>
* {@code @XmlEnum.value()}. Each enum constant {@code @XmlEnumValue}
* must have a valid lexical representation for the type
* <tt>@XmlEnum.value()</tt>
* {@code @XmlEnum.value()}
*
* <p> In the absence of this annotation, {@link Enum#name()} is used
* as the XML representation.

14
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlID.java
View File

@ -38,12 +38,12 @@ import static java.lang.annotation.RetentionPolicy.*;
* To preserve referential integrity of an object graph across XML
* serialization followed by a XML deserialization, requires an object
* reference to be marshalled by reference or containment
* appropriately. Annotations <tt>&#64;XmlID</tt> and <tt>&#64;XmlIDREF</tt>
* appropriately. Annotations {@code @XmlID} and {@code @XmlIDREF}
* together allow a customized mapping of a JavaBean property's
* type by containment or reference.
*
* <p><b>Usage</b> </p>
* The <tt>&#64;XmlID</tt> annotation can be used with the following
* The {@code @XmlID} annotation can be used with the following
* program elements:
* <ul>
* <li> a JavaBean property </li>
@ -56,14 +56,14 @@ import static java.lang.annotation.RetentionPolicy.*;
* The usage is subject to the following constraints:
* <ul>
* <li> At most one field or property in a class can be annotated
* with <tt>&#64;XmlID</tt>. </li>
* <li> The JavaBean property's type must be <tt>java.lang.String</tt>.</li>
* with {@code @XmlID}. </li>
* <li> The JavaBean property's type must be {@code java.lang.String}.</li>
* <li> The only other mapping annotations that can be used
* with <tt>&#64;XmlID</tt>
* are:<tt>&#64;XmlElement</tt> and <tt>&#64;XmlAttribute</tt>.</li>
* with {@code @XmlID}
* are: {@code @XmlElement} and {@code @XmlAttribute}.</li>
* </ul>
*
* <p><b>Example</b>: Map a JavaBean property's type to <tt>xs:ID</tt></p>
* <p><b>Example</b>: Map a JavaBean property's type to {@code xs:ID}</p>
* <pre>
* // Example: code fragment
* public class Customer {

20
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlIDREF.java
View File

@ -38,12 +38,12 @@ import static java.lang.annotation.RetentionPolicy.*;
* To preserve referential integrity of an object graph across XML
* serialization followed by a XML deserialization, requires an object
* reference to be marshaled by reference or containment
* appropriately. Annotations <tt>&#64;XmlID</tt> and <tt>&#64;XmlIDREF</tt>
* appropriately. Annotations {@code @XmlID} and {@code @XmlIDREF}
* together allow a customized mapping of a JavaBean property's
* type by containment or reference.
*
* <p><b>Usage</b> </p>
* The <tt>&#64;XmlIDREF</tt> annotation can be used with the following
* The {@code @XmlIDREF} annotation can be used with the following
* program elements:
* <ul>
* <li> a JavaBean property </li>
@ -58,21 +58,21 @@ import static java.lang.annotation.RetentionPolicy.*;
*
* <li> If the type of the field or property is a collection type,
* then the collection item type must contain a property or
* field annotated with <tt>&#64;XmlID</tt>. </li>
* field annotated with {@code @XmlID}. </li>
* <li> If the field or property is single valued, then the type of
* the property or field must contain a property or field
* annotated with <tt>&#64;XmlID</tt>.
* annotated with {@code @XmlID}.
* <p>Note: If the collection item type or the type of the
* property (for non collection type) is java.lang.Object, then
* the instance must contain a property/field annotated with
* <tt>&#64;XmlID</tt> attribute.
* {@code @XmlID} attribute.
* </li>
* <li> This annotation can be used with the following annotations:
* {@link XmlElement}, {@link XmlAttribute}, {@link XmlList},
* and {@link XmlElements}.</li>
*
* </ul>
* <p><b>Example:</b> Map a JavaBean property to <tt>xs:IDREF</tt>
* <p><b>Example:</b> Map a JavaBean property to {@code xs:IDREF}
* (i.e. by reference rather than by containment)</p>
* <pre>
*
@ -101,10 +101,10 @@ import static java.lang.annotation.RetentionPolicy.*;
* containment versus reference.
*
* <pre>
* // By default, Customer maps to complex type <tt>xs:Customer</tt>
* // By default, Customer maps to complex type {@code xs:Customer}
* public class Customer {
*
* // map JavaBean property type to <tt>xs:ID</tt>
* // map JavaBean property type to {@code xs:ID}
* &#64;XmlID public String getCustomerID();
* public void setCustomerID(String id);
*
@ -112,7 +112,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* }
*
*
* // By default, Invoice maps to a complex type <tt>xs:Invoice</tt>
* // By default, Invoice maps to a complex type {@code xs:Invoice}
* public class Invoice {
*
* // map by reference
@ -122,7 +122,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* // .... other properties not shown here
* }
*
* // By default, Shipping maps to complex type <tt>xs:Shipping</tt>
* // By default, Shipping maps to complex type {@code xs:Shipping}
* public class Shipping {
*
* // map by reference

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlInlineBinaryData.java
View File

@ -41,7 +41,9 @@ import javax.activation.DataHandler;
* base64-encoded binary data in XML.
*
* <p>
* When XOP encoding is enabled as described in {@link AttachmentMarshaller#isXOPPackage()}, this annotation disables datatypes such as {@link java.awt.Image} or {@link Source} or <tt>byte[]</tt> that are bound to base64-encoded binary from being considered for
* When XOP encoding is enabled as described in {@link AttachmentMarshaller#isXOPPackage()},
* this annotation disables datatypes such as {@link java.awt.Image} or {@link Source}
* or {@code byte[]} that are bound to base64-encoded binary from being considered for
* XOP encoding. If a JAXB property is annotated with this annotation or if
* the JAXB property's base type is annotated with this annotation,
* neither

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlList.java
View File

@ -37,7 +37,7 @@ import static java.lang.annotation.ElementType.PARAMETER;
*
* <p><b>Usage</b> </p>
* <p>
* The <tt>@XmlList</tt> annotation can be used with the
* The {@code @XmlList} annotation can be used with the
* following program elements:
* <ul>
* <li> JavaBean property </li>
@ -92,12 +92,12 @@ import static java.lang.annotation.ElementType.PARAMETER;
* {@link XmlValue},
* {@link XmlIDREF}.
* <ul>
* <li> The use of <tt>@XmlList</tt> with {@link XmlValue} while
* <li> The use of {@code @XmlList} with {@link XmlValue} while
* allowed, is redundant since {@link XmlList} maps a
* collection type to a simple schema type that derives by
* list just as {@link XmlValue} would. </li>
*
* <li> The use of <tt>@XmlList</tt> with {@link XmlAttribute} while
* <li> The use of {@code @XmlList} with {@link XmlAttribute} while
* allowed, is redundant since {@link XmlList} maps a
* collection type to a simple schema type that derives by
* list just as {@link XmlAttribute} would. </li>

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlNs.java
View File

@ -34,13 +34,13 @@ import java.lang.annotation.Target;
* Associates a namespace prefix with a XML namespace URI.
*
* <p><b>Usage</b></p>
* <p><tt>@XmlNs</tt> annotation is intended for use from other
* <p>{@code @XmlNs} annotation is intended for use from other
* program annotations.
*
* <p>See "Package Specification" in javax.xml.bind.package javadoc for
* additional common information.</p>
*
* <p><b>Example:</b>See <tt>XmlSchema</tt> annotation type for an example.
* <p><b>Example:</b>See {@code XmlSchema} annotation type for an example.
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since 1.6, JAXB 2.0
*/

16
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchema.java
View File

@ -163,12 +163,12 @@ public @interface XmlSchema {
* manually.
*
* <p>
* Value could be any absolute URI, like <tt>http://example.org/some.xsd</tt>.
* Value could be any absolute URI, like {@code http://example.org/some.xsd}.
* It is also possible to specify the empty string, to indicate
* that the schema is externally available but the location is
* unspecified (and thus it's the responsibility of the reader of the generate
* schema to locate it.) Finally, the default value of this property
* <tt>"##generate"</tt> indicates that the schema generator is going
* {@code "##generate"} indicates that the schema generator is going
* to generate components for this namespace (as it did in JAXB 2.0.)
*
* <p>
@ -179,17 +179,17 @@ public @interface XmlSchema {
*
* <h3>Note to implementor</h3>
* <p>
* More precisely, the value must be either <tt>""</tt>, <tt>"##generate"</tt>, or
* More precisely, the value must be either {@code ""}, {@code "##generate"}, or
* <a href="http://www.w3.org/TR/xmlschema-2/#anyURI">
* a valid lexical representation of <tt>xs:anyURI</tt></a> that begins
* with <tt>&lt;scheme&gt;:</tt>.
* a valid lexical representation of {@code xs:anyURI}</a> that begins
* with {@code <scheme>:}.
*
* <p>
* A schema generator is expected to generate a corresponding
* <tt>&lt;xs:import namespace="..." schemaLocation="..."/&gt;</tt> (or
* no <tt>schemaLocation</tt> attribute at all if the empty string is specified.)
* {@code <xs:import namespace="..." schemaLocation="..."/>} (or
* no {@code schemaLocation} attribute at all if the empty string is specified.)
* However, the schema generator is allowed to use a different value in
* the <tt>schemaLocation</tt> attribute (including not generating
* the {@code schemaLocation} attribute (including not generating
* such attribute), for example so that the user can specify a local
* copy of the resource through the command line interface.
*

8
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaType.java
View File

@ -38,7 +38,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
*
* <p> <b>Usage</b> </p>
* <p>
* <tt>@XmlSchemaType</tt> annotation can be used with the following program
* {@code @XmlSchemaType} annotation can be used with the following program
* elements:
* <ul>
* <li> a JavaBean property </li>
@ -46,10 +46,10 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* <li> package</li>
* </ul>
*
* <p> <tt>@XmlSchemaType</tt> annotation defined for Java type
* <p> {@code @XmlSchemaType} annotation defined for Java type
* applies to all references to the Java type from a property/field.
* A <tt>@XmlSchemaType</tt> annotation specified on the
* property/field overrides the <tt>@XmlSchemaType</tt> annotation
* A {@code @XmlSchemaType} annotation specified on the
* property/field overrides the {@code @XmlSchemaType} annotation
* specified at the package level.
*
* <p> This annotation can be used with the following annotations:

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaTypes.java
View File

@ -41,7 +41,7 @@ import java.lang.annotation.Target;
* <pre>
* &#64;XmlSchemaTypes({ @XmlSchemaType(...), @XmlSchemaType(...) })
* </pre>
* <p>The <tt>@XmlSchemaTypes</tt> annnotation can be used to
* <p>The {@code @XmlSchemaTypes} annnotation can be used to
* define {@link XmlSchemaType} for different types at the
* package level.
*

10
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSeeAlso.java
View File

@ -51,9 +51,9 @@ import java.lang.annotation.Target;
*
* <p>
* The user would be required to create {@link JAXBContext} as
* <tt>JAXBContext.newInstance(Dog.class,Cat.class)</tt>
* (<tt>Animal</tt> will be automatically picked up since <tt>Dog</tt>
* and <tt>Cat</tt> refers to it.)
* {@code JAXBContext.newInstance(Dog.class,Cat.class)}
* ({@code Animal} will be automatically picked up since {@code Dog}
* and {@code Cat} refers to it.)
*
* <p>
* {@link XmlSeeAlso} annotation would allow you to write:
@ -65,9 +65,9 @@ import java.lang.annotation.Target;
* </pre>
*
* <p>
* This would allow you to do <tt>JAXBContext.newInstance(Animal.class)</tt>.
* This would allow you to do {@code JAXBContext.newInstance(Animal.class)}.
* By the help of this annotation, JAXB implementations will be able to
* correctly bind <tt>Dog</tt> and <tt>Cat</tt>.
* correctly bind {@code Dog} and {@code Cat}.
*
* @author Kohsuke Kawaguchi
* @since 1.6, JAXB 2.1

8
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlTransient.java
View File

@ -34,14 +34,14 @@ import static java.lang.annotation.RetentionPolicy.*;
* <p>
* Prevents the mapping of a JavaBean property/type to XML representation.
* <p>
* The <tt>@XmlTransient</tt> annotation is useful for resolving name
* The {@code @XmlTransient} annotation is useful for resolving name
* collisions between a JavaBean property name and a field name or
* preventing the mapping of a field/property. A name collision can
* occur when the decapitalized JavaBean property name and a field
* name are the same. If the JavaBean property refers to the field,
* then the name collision can be resolved by preventing the
* mapping of either the field or the JavaBean property using the
* <tt>@XmlTransient</tt> annotation.
* {@code @XmlTransient} annotation.
*
* <p>
* When placed on a class, it indicates that the class shouldn't be mapped
@ -49,7 +49,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* with its derived classes, as if the class is inlined.
*
* <p><b>Usage</b></p>
* <p> The <tt>@XmlTransient</tt> annotation can be used with the following
* <p> The {@code @XmlTransient} annotation can be used with the following
* program elements:
* <ul>
* <li> a JavaBean property </li>
@ -57,7 +57,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* <li> class </li>
* </ul>
*
* <p><tt>@XmlTransient</tt>is mutually exclusive with all other
* <p>{@code @XmlTransient} is mutually exclusive with all other
* JAXB defined annotations. </p>
*
* <p>See "Package Specification" in javax.xml.bind.package javadoc for

54
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlType.java
View File

@ -35,7 +35,7 @@ import java.lang.annotation.Target;
* Maps a class or an enum type to a XML Schema type.
*
* <p><b>Usage</b></p>
* <p> The <tt>@XmlType</tt> annnotation can be used with the following program
* <p> The {@code @XmlType} annnotation can be used with the following program
* elements:
* <ul>
* <li> a top level class </li>
@ -53,8 +53,8 @@ import java.lang.annotation.Target;
* schema type's content model (e.g. model groups, attributes etc).
* <p> To be mapped, a class must either have a public no-arg
* constructor or a static no-arg factory method. The static factory
* method can be specified in <tt>factoryMethod()</tt> and
* <tt>factoryClass()</tt> annotation elements. The static factory
* method can be specified in {@code factoryMethod()} and
* {@code factoryClass()} annotation elements. The static factory
* method or the no-arg constructor is used during unmarshalling to
* create an instance of this class. If both are present, the static
* factory method overrides the no-arg constructor.
@ -64,7 +64,7 @@ import java.lang.annotation.Target;
* mapping of JavaBean properties and fields contained within the
* class. The schema type to which the class is mapped can either be
* named or anonymous. A class can be mapped to an anonymous schema
* type by annotating the class with <tt>&#64;XmlType(name="")</tt>.
* type by annotating the class with {@code @XmlType(name="")}.
* <p>
* Either a global element, local element or a local attribute can be
* associated with an anonymous type as follows:
@ -84,29 +84,29 @@ import java.lang.annotation.Target;
* </ul>
* <b> Mapping to XML Schema Complex Type </b>
* <ul>
* <li>If class is annotated with <tt>@XmlType(name="") </tt>, it
* <li>If class is annotated with {@code @XmlType(name="") }, it
* is mapped to an anonymous type otherwise, the class name maps
* to a complex type name. The <tt>XmlName()</tt> annotation element
* to a complex type name. The {@code XmlName()} annotation element
* can be used to customize the name.</li>
*
* <li> Properties and fields that are mapped to elements are mapped to a
* content model within a complex type. The annotation element
* <tt>propOrder()</tt> can be used to customize the content model to be
* <tt>xs:all</tt> or <tt>xs:sequence</tt>. It is used for specifying
* the order of XML elements in <tt>xs:sequence</tt>. </li>
* {@code propOrder()} can be used to customize the content model to be
* {@code xs:all} or {@code xs:sequence}. It is used for specifying
* the order of XML elements in {@code xs:sequence}. </li>
*
* <li> Properties and fields can be mapped to attributes within the
* complex type. </li>
*
* <li> The targetnamespace of the XML Schema type can be customized
* using the annotation element <tt>namespace()</tt>. </li>
* using the annotation element {@code namespace()}. </li>
* </ul>
*
* <p>
* <b> Mapping class to XML Schema simple type </b>
* <p>
* A class can be mapped to a XML Schema simple type using the
* <tt>@XmlValue</tt> annotation. For additional details and examples,
* {@code @XmlValue} annotation. For additional details and examples,
* see @{@link XmlValue} annotation type.
* <p>
* The following table shows the mapping of the class to a XML Schema
@ -114,8 +114,8 @@ import java.lang.annotation.Target;
* <ul>
* <li> {@literal ->} : represents a mapping </li>
* <li> [x]+ : one or more occurances of x </li>
* <li> [ <tt>@XmlValue</tt> property ]: JavaBean property annotated with
* <tt>@XmlValue</tt></li>
* <li> [ {@code @XmlValue} property ]: JavaBean property annotated with
* {@code @XmlValue}</li>
* <li> X : don't care
* </ul>
* <blockquote>
@ -156,7 +156,7 @@ import java.lang.annotation.Target;
* <tr valign="top">
* <td>Class</td>
* <td>X</td>
* <td>1 [<tt>@XmlValue</tt> property] {@literal &&} <br> [property]+ {@literal ->} attributes</td>
* <td>1 [{@code @XmlValue} property] {@literal &&} <br> [property]+ {@literal ->} attributes</td>
* <td>simplecontent</td>
* <td> </td>
* </tr>
@ -164,7 +164,7 @@ import java.lang.annotation.Target;
* <tr valign="top">
* <td>Class</td>
* <td>X</td>
* <td>1 [<tt>@XmlValue</tt> property] {@literal &&} <br> no properties {@literal ->} attribute</td>
* <td>1 [{@code @XmlValue} property] {@literal &&} <br> no properties {@literal ->} attribute</td>
* <td> </td>
* <td>simpletype</td>
* </tr>
@ -176,8 +176,8 @@ import java.lang.annotation.Target;
*
* An enum type maps to a XML schema simple type with enumeration
* facets. The following annotation elements are ignored since they
* are not meaningful: <tt>propOrder()</tt> , <tt>factoryMethod()</tt> ,
* <tt>factoryClass()</tt> .
* are not meaningful: {@code propOrder()} , {@code factoryMethod()} ,
* {@code factoryClass()} .
*
* <h3> Usage with other annotations </h3>
* <p> This annotation can be used with the following annotations:
@ -406,7 +406,7 @@ public @interface XmlType {
* <p> All of the JavaBean properties being mapped to XML Schema elements
* must be listed.
* <p> A JavaBean property or field listed in propOrder must not
* be transient or annotated with <tt>@XmlTransient</tt>.
* be transient or annotated with {@code @XmlTransient}.
* <p> The default ordering of JavaBean properties is determined
* by @{@link XmlAccessorOrder}.
*/
@ -423,18 +423,18 @@ public @interface XmlType {
* Class containing a no-arg factory method for creating an
* instance of this class. The default is this class.
*
* <p>If <tt>factoryClass</tt> is DEFAULT.class and
* <tt>factoryMethod</tt> is "", then there is no static factory
* <p>If {@code factoryClass} is DEFAULT.class and
* {@code factoryMethod} is "", then there is no static factory
* method.
*
* <p>If <tt>factoryClass</tt> is DEFAULT.class and
* <tt>factoryMethod</tt> is not "", then
* <tt>factoryMethod</tt> is the name of a static factory method
* <p>If {@code factoryClass} is DEFAULT.class and
* {@code factoryMethod} is not "", then
* {@code factoryMethod} is the name of a static factory method
* in this class.
*
* <p>If <tt>factoryClass</tt> is not DEFAULT.class, then
* <tt>factoryMethod</tt> must not be "" and must be the name of
* a static factory method specified in <tt>factoryClass</tt>.
* <p>If {@code factoryClass} is not DEFAULT.class, then
* {@code factoryMethod} must not be "" and must be the name of
* a static factory method specified in {@code factoryClass}.
*/
Class factoryClass() default DEFAULT.class;
@ -447,7 +447,7 @@ public @interface XmlType {
/**
* Name of a no-arg factory method in the class specified in
* <tt>factoryClass</tt> factoryClass().
* {@code factoryClass} factoryClass().
*
*/
String factoryMethod() default "";

8
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlValue.java
View File

@ -39,7 +39,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* <p>
* <b> Usage: </b>
* <p>
* The <tt>@XmlValue</tt> annotation can be used with the following program
* The {@code @XmlValue} annotation can be used with the following program
* elements:
* <ul>
* <li> a JavaBean property.</li>
@ -52,9 +52,9 @@ import static java.lang.annotation.RetentionPolicy.*;
* The usage is subject to the following usage constraints:
* <ul>
* <li>At most one field or property can be annotated with the
* <tt>@XmlValue</tt> annotation. </li>
* {@code @XmlValue} annotation. </li>
*
* <li><tt>@XmlValue</tt> can be used with the following
* <li>{@code @XmlValue} can be used with the following
* annotations: {@link XmlList}. However this is redundant since
* {@link XmlList} maps a type to a simple schema type that derives by
* list just as {@link XmlValue} would. </li>
@ -73,7 +73,7 @@ import static java.lang.annotation.RetentionPolicy.*;
* simple type.
*
* If there are additional JavaBean properties (other than the
* JavaBean property annotated with <tt>@XmlValue</tt> annotation)
* JavaBean property annotated with {@code @XmlValue} annotation)
* that are mapped to XML attributes, then the class is mapped to a
* complex type with simpleContent.
* </p>

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/CollapsedStringAdapter.java
View File

@ -28,7 +28,7 @@ package javax.xml.bind.annotation.adapters;
/**
* Built-in {@link XmlAdapter} to handle <tt>xs:token</tt> and its derived types.
* Built-in {@link XmlAdapter} to handle {@code xs:token} and its derived types.
*
* <p>
* This adapter removes leading and trailing whitespaces, then truncate any

4
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/HexBinaryAdapter.java
View File

@ -28,10 +28,10 @@ package javax.xml.bind.annotation.adapters;
import javax.xml.bind.DatatypeConverter;
/**
* {@link XmlAdapter} for <tt>xs:hexBinary</tt>.
* {@link XmlAdapter} for {@code xs:hexBinary}.
*
* <p>
* This {@link XmlAdapter} binds <tt>byte[]</tt> to the hexBinary representation in XML.
* This {@link XmlAdapter} binds {@code byte[]} to the hexBinary representation in XML.
*
* @author Kohsuke Kawaguchi
* @since 1.6, JAXB 2.0

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/NormalizedStringAdapter.java
View File

@ -28,7 +28,7 @@ package javax.xml.bind.annotation.adapters;
/**
* {@link XmlAdapter} to handle <tt>xs:normalizedString</tt>.
* {@link XmlAdapter} to handle {@code xs:normalizedString}.
*
* <p>
* Replaces any tab, CR, and LF by a whitespace character ' ',

10
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlAdapter.java
View File

@ -32,7 +32,7 @@ package javax.xml.bind.annotation.adapters;
*
* <p>
* Some Java types do not map naturally to a XML representation, for
* example <tt>HashMap</tt> or other non JavaBean classes. Conversely,
* example {@code HashMap} or other non JavaBean classes. Conversely,
* a XML repsentation may map to a Java type but an application may
* choose to accesss the XML representation using another Java
* type. For example, the schema to Java binding rules bind
@ -68,10 +68,10 @@ package javax.xml.bind.annotation.adapters;
* XmlJavaTypeAdapter} </li>
* </ul>
*
* <p><b>Example:</b> Customized mapping of <tt>HashMap</tt></p>
* <p><b>Example:</b> Customized mapping of {@code HashMap}</p>
* <p> The following example illustrates the use of
* <tt>&#64;XmlAdapter</tt> and <tt>&#64;XmlJavaTypeAdapter</tt> to
* customize the mapping of a <tt>HashMap</tt>.
* {@code @XmlAdapter} and {@code @XmlJavaTypeAdapter} to
* customize the mapping of a {@code HashMap}.
*
* <p> <b> Step 1: </b> Determine the desired XML representation for HashMap.
*
@ -154,7 +154,7 @@ package javax.xml.bind.annotation.adapters;
* @param <BoundType>
* The type that JAXB doesn't know how to handle. An adapter is written
* to allow this type to be used as an in-memory representation through
* the <tt>ValueType</tt>.
* the {@code ValueType}.
* @param <ValueType>
* The type that JAXB knows how to handle out of the box.
*

18
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.java
View File

@ -50,7 +50,7 @@ import static java.lang.annotation.ElementType.PACKAGE;
*
* <p> <b> Usage: </b> </p>
*
* <p> The <tt>@XmlJavaTypeAdapter</tt> annotation can be used with the
* <p> The {@code @XmlJavaTypeAdapter} annotation can be used with the
* following program elements:
* <ul>
* <li> a JavaBean property </li>
@ -60,20 +60,20 @@ import static java.lang.annotation.ElementType.PACKAGE;
* <li> from within {@link XmlJavaTypeAdapters} </li>
* </ul>
*
* <p> When <tt>@XmlJavaTypeAdapter</tt> annotation is defined on a
* <p> When {@code @XmlJavaTypeAdapter} annotation is defined on a
* class, it applies to all references to the class.
* <p> When <tt>@XmlJavaTypeAdapter</tt> annotation is defined at the
* <p> When {@code @XmlJavaTypeAdapter} annotation is defined at the
* package level it applies to all references from within the package
* to <tt>@XmlJavaTypeAdapter.type()</tt>.
* <p> When <tt>@XmlJavaTypeAdapter</tt> annotation is defined on the
* to {@code @XmlJavaTypeAdapter.type()}.
* <p> When {@code @XmlJavaTypeAdapter} annotation is defined on the
* field, property or parameter, then the annotation applies to the
* field, property or the parameter only.
* <p> A <tt>@XmlJavaTypeAdapter</tt> annotation on a field, property
* or parameter overrides the <tt>@XmlJavaTypeAdapter</tt> annotation
* <p> A {@code @XmlJavaTypeAdapter} annotation on a field, property
* or parameter overrides the {@code @XmlJavaTypeAdapter} annotation
* associated with the class being referenced by the field, property
* or parameter.
* <p> A <tt>@XmlJavaTypeAdapter</tt> annotation on a class overrides
* the <tt>@XmlJavaTypeAdapter</tt> annotation specified at the
* <p> A {@code @XmlJavaTypeAdapter} annotation on a class overrides
* the {@code @XmlJavaTypeAdapter} annotation specified at the
* package level for that class.
*
* <p>This annotation can be used with the following other annotations:

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapters.java
View File

@ -42,7 +42,7 @@ import java.lang.annotation.Target;
* &#64;XmlJavaTypeAdapters ({ @XmlJavaTypeAdapter(...),@XmlJavaTypeAdapter(...) })
* </pre>
*
* <p>The <tt>@XmlJavaTypeAdapters</tt> annotation is useful for
* <p>The {@code @XmlJavaTypeAdapters} annotation is useful for
* defining {@link XmlJavaTypeAdapter} annotations for different types
* at the package level.
*

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentMarshaller.java
View File

@ -123,7 +123,7 @@ public abstract class AttachmentMarshaller {
*
* @param data
* represents the data to be attached. Must be non-null. The actual data region is
* specified by <tt>(data,offset,length)</tt> tuple.
* specified by {@code (data,offset,length)} tuple.
*
* @param offset
* The offset within the array of the first byte to be read;

30
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentUnmarshaller.java
View File

@ -36,9 +36,10 @@ import javax.activation.DataHandler;
* understanding of the packaging format being used to a MIME-based
* package processor that implements this abstract class.</p>
*
* <p>This abstract class identifies if a package requires XOP processing, {@link #isXOPPackage()} and provides retrieval of binary content stored as attachments by content-id.</p>
* <p>This abstract class identifies if a package requires XOP processing, {@link #isXOPPackage()}
* and provides retrieval of binary content stored as attachments by content-id.</p>
*
* <h2>Identifying the content-id, cid, to pass to <code>getAttachment*(String cid)</code></h2>
* <h2>Identifying the content-id, cid, to pass to {@code getAttachment*(String cid)}</h2>
* <ul>
* <li>
* For XOP processing, the infoset representation of the cid is described
@ -47,8 +48,9 @@ import javax.activation.DataHandler;
* </li>
* <li>
* For WS-I AP 1.0, the cid is identified as an element or attribute of
* type <code>ref:swaRef </code> specified in
* <a href="http://www.ws-i.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html#Referencing_Attachments_from_the_SOAP_Envelope">Section 4.4 Referencing Attachments from the SOAP Envelope</a>
* type {@code ref:swaRef} specified in
* <a href="http://www.ws-i.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html#Referencing_Attachments_from_the_SOAP_Envelope">
* Section 4.4 Referencing Attachments from the SOAP Envelope</a>
* </li>
* </ul>
*
@ -66,9 +68,9 @@ import javax.activation.DataHandler;
*/
public abstract class AttachmentUnmarshaller {
/**
* <p>Lookup MIME content by content-id, <code>cid</code>, and return as a {@link DataHandler}.</p>
* <p>Lookup MIME content by content-id, {@code cid}, and return as a {@link DataHandler}.</p>
*
* <p>The returned <code>DataHandler</code> instance must be configured
* <p>The returned {@code DataHandler} instance must be configured
* to meet the following required mapping constaint.
* <table summary="" border="2" rules="all" cellpadding="4">
* <thead>
@ -81,8 +83,8 @@ public abstract class AttachmentUnmarshaller {
* <th>Java Type</th>
* </tr>
* <tr>
* <th><code>DataHandler.getContentType()</code></th>
* <th><code>instanceof DataHandler.getContent()</code></th>
* <th>{@code DataHandler.getContentType()}</th>
* <th>{@code instanceof DataHandler.getContent()}</th>
* </tr>
* </thead>
* <tbody>
@ -103,8 +105,8 @@ public abstract class AttachmentUnmarshaller {
* Note that it is allowable to support additional mappings.
*
* @param cid It is expected to be a valid lexical form of the XML Schema
* <code>xs:anyURI</code> datatype. If <code>{@link #isXOPPackage()}
* ==true</code>, it must be a valid URI per the <code>cid:</code> URI scheme (see <a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a>)
* {@code xs:anyURI} datatype. If {@link #isXOPPackage()}{@code ==true},
* it must be a valid URI per the {@code cid:} URI scheme (see <a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a>)
*
* @return
* a {@link DataHandler} that represents the MIME attachment.
@ -114,11 +116,11 @@ public abstract class AttachmentUnmarshaller {
public abstract DataHandler getAttachmentAsDataHandler(String cid);
/**
* <p>Retrieve the attachment identified by content-id, <code>cid</code>, as a <tt>byte[]</tt></p>.
* <p>Retrieve the attachment identified by content-id, {@code cid}, as a {@code byte[]}.
*
* @param cid It is expected to be a valid lexical form of the XML Schema
* <code>xs:anyURI</code> datatype. If <code>{@link #isXOPPackage()}
* ==true</code>, it must be a valid URI per the <code>cid:</code> URI scheme (see <a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a>)
* {@code xs:anyURI} datatype. If {@link #isXOPPackage()}{@code ==true},
* it must be a valid URI per the {@code cid:} URI scheme (see <a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a>)
*
* @return byte[] representation of attachment identified by cid.
*
@ -129,7 +131,7 @@ public abstract class AttachmentUnmarshaller {
/**
* <p>Read-only property that returns true if JAXB unmarshaller needs to perform XOP processing.</p>
*
* <p>This method returns <code>true</code> when the constraints specified
* <p>This method returns {@code true} when the constraints specified
* in <a href="http://www.w3.org/TR/2005/REC-xop10-20050125/#identifying_xop_documents">Identifying XOP Documents</a> are met.
* This value must not change during the unmarshalling process.</p>
*

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractMarshallerImpl.java
View File

@ -48,7 +48,7 @@ import java.io.IOException;
// import java.nio.charset.UnsupportedCharsetException;
/**
* Partial default <tt>Marshaller</tt> implementation.
* Partial default {@code Marshaller} implementation.
*
* <p>
* This class provides a partial default implementation for the

6
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractUnmarshallerImpl.java
View File

@ -53,7 +53,7 @@ import java.net.MalformedURLException;
import java.net.URL;
/**
* Partial default <tt>Unmarshaller</tt> implementation.
* Partial default {@code Unmarshaller} implementation.
*
* <p>
* This class provides a partial default implementation for the
@ -246,7 +246,7 @@ public abstract class AbstractUnmarshallerImpl implements Unmarshaller
* <p>
* The validation event handler will be called by the JAXB Provider if any
* validation errors are encountered during calls to any of the
* <tt>unmarshal</tt> methods. If the client application does not register
* {@code unmarshal} methods. If the client application does not register
* a validation event handler before invoking the unmarshal methods, then
* all validation events will be silently ignored and may result in
* unexpected behaviour.
@ -267,7 +267,7 @@ public abstract class AbstractUnmarshallerImpl implements Unmarshaller
/**
* Specifies whether or not the Unmarshaller should validate during
* unmarshal operations. By default, the <tt>Unmarshaller</tt> does
* unmarshal operations. By default, the {@code Unmarshaller} does
* not validate.
* <p>
* This method may only be invoked before or after calling one of the

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/helpers/package.html
View File

@ -34,7 +34,7 @@
<p>
<B>JAXB Provider Use Only:</b> Provides partial default implementations for
some of the <tt>javax.xml.bind</tt> interfaces.
some of the <code>javax.xml.bind</code> interfaces.
<p>
JAXB Providers can extend these classes and implement the abstract

2
jaxws/src/java.xml.bind/share/classes/javax/xml/bind/package.html
View File

@ -37,7 +37,7 @@
unmarshalling, marshalling, and validation capabilities.
<p>
<tt>JAXBContext</tt> is the client-entry point to the runtime binding
<code>JAXBContext</code> is the client-entry point to the runtime binding
framework.

2
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/messaging/saaj/SOAPExceptionImpl.java
View File

@ -144,7 +144,7 @@ public class SOAPExceptionImpl extends SOAPException {
* @param cause the <code>Throwable</code> object that caused this
* <code>SOAPExceptionImpl</code> object to be thrown. The value of this
* parameter is saved for later retrieval by the
* {@link #getCause()} method. A <tt>null</tt> value is
* {@link #getCause()} method. A {@code null} value is
* permitted and indicates that the cause is nonexistent or
* unknown.
* @return a reference to this <code>SOAPExceptionImpl</code> instance

10
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/addressing/WsaPropertyBag.java
View File

@ -69,7 +69,7 @@ public class WsaPropertyBag extends BasePropertySet {
}
/**
* Gets the <tt>wsa:To</tt> header.
* Gets the {@code wsa:To} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@ -85,7 +85,7 @@ public class WsaPropertyBag extends BasePropertySet {
}
/**
* Gets the <tt>wsa:To</tt> header.
* Gets the {@code wsa:To} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@ -101,7 +101,7 @@ public class WsaPropertyBag extends BasePropertySet {
}
/**
* Gets the <tt>wsa:From</tt> header.
* Gets the {@code wsa:From} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@ -112,7 +112,7 @@ public class WsaPropertyBag extends BasePropertySet {
}
/**
* Gets the <tt>wsa:Action</tt> header content as String.
* Gets the {@code wsa:Action} header content as String.
*
* @return
* null if the incoming SOAP message didn't have the header.
@ -128,7 +128,7 @@ public class WsaPropertyBag extends BasePropertySet {
}
/**
* Gets the <tt>wsa:MessageID</tt> header content as String.
* Gets the {@code wsa:MessageID} header content as String.
*
* @return
* null if the incoming SOAP message didn't have the header.

4
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingID.java
View File

@ -164,7 +164,7 @@ public abstract class BindingID {
*
* <p>
* For example, {@link BindingID} for
* <tt>"{@value SOAPBinding#SOAP11HTTP_MTOM_BINDING}"</tt>
* {@code "{@value SOAPBinding#SOAP11HTTP_MTOM_BINDING}"}
* would always return a list that has {@link MTOMFeature} enabled.
*/
public WebServiceFeatureList createBuiltinFeatureList() {
@ -189,7 +189,7 @@ public abstract class BindingID {
*
* <p>
* Some binding ID, such as those for SOAP/HTTP, uses the URL
* query syntax (like <tt>?mtom=true</tt>) to control
* query syntax (like {@code ?mtom=true}) to control
* the optional part of the binding. This method obtains
* the value for such optional parts.
*

2
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingIDFactory.java
View File

@ -36,7 +36,7 @@ import javax.xml.ws.WebServiceException;
* <p>
* When the JAX-WS RI is asked to parse a binding ID string into a {@link BindingID}
* object, it uses service idiom to look for the implementations of this class
* in the <tt>META-INF/services/...</tt>.
* in the {@code META-INF/services/...}.
*
* @since JAX-WS 2.0.next
* @author Kohsuke Kawaguchi

10
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/Cancelable.java
View File

@ -35,18 +35,18 @@ public interface Cancelable {
* Attempts to cancel execution of this task. This attempt will
* fail if the task has already completed, has already been cancelled,
* or could not be cancelled for some other reason. If successful,
* and this task has not started when <tt>cancel</tt> is called,
* and this task has not started when {@code cancel} is called,
* this task should never run. If the task has already started,
* then the <tt>mayInterruptIfRunning</tt> parameter determines
* then the {@code mayInterruptIfRunning} parameter determines
* whether the thread executing this task should be interrupted in
* an attempt to stop the task.
*
* @param mayInterruptIfRunning <tt>true</tt> if the thread executing this
* @param mayInterruptIfRunning {@code true} if the thread executing this
* task should be interrupted; otherwise, in-progress tasks are allowed
* to complete
* @return <tt>false</tt> if the task could not be cancelled,
* @return {@code false} if the task could not be cancelled,
* typically because it has already completed normally;
* <tt>true</tt> otherwise
* {@code true} otherwise
*/
public void cancel(boolean mayInterruptIfRunning);
}

2
jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ClientPipelineHook.java
View File

@ -63,7 +63,7 @@ public abstract class ClientPipelineHook {
* eventually processes messages.
*
* @return
* The default implementation just returns <tt>tail</tt>, which means
* The default implementation just returns {@code tail}, which means
* no additional pipe is inserted. If the implementation adds
* new pipes, return the new head pipe.
*/

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