jdk8-mips64-public/jaxws: src/share/jaxws_classes/com/sun/xml/internal/ws/client/ContentNegotiation.java@7166269ef0f1

     1 /*

     2  * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.

     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4  *

     5  * This code is free software; you can redistribute it and/or modify it

     6  * under the terms of the GNU General Public License version 2 only, as

     7  * published by the Free Software Foundation.  Oracle designates this

     8  * particular file as subject to the "Classpath" exception as provided

     9  * by Oracle in the LICENSE file that accompanied this code.

    10  *

    11  * This code is distributed in the hope that it will be useful, but WITHOUT

    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    14  * version 2 for more details (a copy is included in the LICENSE file that

    15  * accompanied this code).

    16  *

    17  * You should have received a copy of the GNU General Public License version

    18  * 2 along with this work; if not, write to the Free Software Foundation,

    19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    20  *

    21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    22  * or visit www.oracle.com if you need additional information or have any

    23  * questions.

    24  */

    26 package com.sun.xml.internal.ws.client;

    28 /**

    29  * Content negotiation enum.

    30  * <p>

    31  * A value of {@link #none} means no content negotation at level of the

    32  * client transport will be performed to negotiate the encoding of XML infoset.

    33  * The default encoding will always be used.

    34  * <p>

    35  * A value of {@link #pessimistic} means the client transport will assume

    36  * the default encoding of XML infoset for an outbound message unless informed

    37  * otherwise by a previously received inbound message.

    38  * (The client transport initially and pessimistically assumes that a service

    39  * does not support anything other than the default encoding of XML infoset.)

    40  * <p>

    41  * A value of {@link #optimistic} means the client transport will assume

    42  * a non-default encoding of XML infoset for an outbound message.

    43  * (The client transport optimistically assumes that a service

    44  * supports the non-default encoding of XML infoset.)

    45  *

    46  * @author Paul.Sandoz@Sun.Com

    47  */

    48 public enum ContentNegotiation {

    49     none,

    50     pessimistic,

    51     optimistic;

    53     /**

    54      * Property name for content negotiation on {@link RequestContext}.

    55      */

    56     public static final String PROPERTY = "com.sun.xml.internal.ws.client.ContentNegotiation";

    58     /**

    59      * Obtain the content negotiation value from a system property.

    60      * <p>

    61      * This method will never throw a runtime exception.

    62      *

    63      * @return the content negotiation value.

    64      */

    65     public static ContentNegotiation obtainFromSystemProperty() {

    66         try {

    67             String value = System.getProperty(PROPERTY);

    69             if (value == null) {

    70                 return none;

    71             }

    73             return valueOf(value);

    74         } catch (Exception e) {

    75             // Default to none for any unrecognized value or any other

    76             // runtime exception thrown

    77             return none;

    78         }

    79     }

    80 }

Mercurial > jdk8-mips64-public > jaxws / file revision