com.sun.xml.ws.client
Enum ContentNegotiation

java.lang.Object
  extended by java.lang.Enum<ContentNegotiation>
      extended by com.sun.xml.ws.client.ContentNegotiation
All Implemented Interfaces:
Serializable, Comparable<ContentNegotiation>

public enum ContentNegotiation
extends Enum<ContentNegotiation>

Content negotiation enum.

A value of none means no content negotation at level of the client transport will be performed to negotiate the encoding of XML infoset. The default encoding will always be used.

A value of pessimistic means the client transport will assume the default encoding of XML infoset for an outbound message unless informed otherwise by a previously received inbound message. (The client transport initially and pessimistically assumes that a service does not support anything other than the default encoding of XML infoset.)

A value of optimistic means the client transport will assume a non-default encoding of XML infoset for an outbound message. (The client transport optimistically assumes that a service supports the non-default encoding of XML infoset.)


Enum Constant Summary
none
           
optimistic
           
pessimistic
           
 
Field Summary
static String PROPERTY
          Property name for content negotiation on RequestContext.
 
Method Summary
static ContentNegotiation obtainFromSystemProperty()
          Obtain the content negotiation value from a system property.
static ContentNegotiation valueOf(String name)
          Returns the enum constant of this type with the specified name.
static ContentNegotiation[] values()
          Returns an array containing the constants of this enum type, in the order they are declared.
 
Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Enum Constant Detail

none

public static final ContentNegotiation none

pessimistic

public static final ContentNegotiation pessimistic

optimistic

public static final ContentNegotiation optimistic
Field Detail

PROPERTY

public static final String PROPERTY
Property name for content negotiation on RequestContext.

See Also:
Constant Field Values
Method Detail

values

public static ContentNegotiation[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
for (ContentNegotiation c : ContentNegotiation.values())
    System.out.println(c);

Returns:
an array containing the constants of this enum type, in the order they are declared

valueOf

public static ContentNegotiation valueOf(String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:
name - the name of the enum constant to be returned.
Returns:
the enum constant with the specified name
Throws:
IllegalArgumentException - if this enum type has no constant with the specified name
NullPointerException - if the argument is null

obtainFromSystemProperty

public static ContentNegotiation obtainFromSystemProperty()
Obtain the content negotiation value from a system property.

This method will never throw a runtime exception.

Returns:
the content negotiation value.