com.sun.xml.ws.client

Enum ContentNegotiation

java.lang.Object

java.lang.Enum<ContentNegotiation>

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.)

Property Summary

Properties

Type	Property and Description
static ContentNegotiation	obtainFromSystem Obtain the content negotiation value from a system property.

Enum Constant Summary

Enum Constants

Enum Constant and Description
none
optimistic
pessimistic

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROPERTY Property name for content negotiation on RequestContext.

Method Summary

Methods

Modifier and Type	Method and Description
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

Property Detail

obtainFromSystem

Obtain the content negotiation value from a system property.

This method will never throw a runtime exception.

Returns:

the content negotiation value.

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.