jdk/src/share/classes/com/sun/beans/decoder/DoubleElementHandler.java
author malenkov
Tue, 29 Oct 2013 17:01:06 +0400
changeset 21278 ef8a3a2a72f2
parent 5506 202f599c92aa
child 23010 6dadb192ad81
permissions -rw-r--r--
8022746: List of spelling errors in API doc Reviewed-by: alexsch, smarks
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     1
/*
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
     2
 * Copyright (c) 2008, Oracle and/or its affiliates. All rights reserved.
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     4
 *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    10
 *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    15
 * accompanied this code).
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    16
 *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    20
 *
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 1844
diff changeset
    23
 * questions.
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    24
 */
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    25
package com.sun.beans.decoder;
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    26
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    27
/**
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    28
 * This class is intended to handle <double> element.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    29
 * This element specifies {@code double} values.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    30
 * The class {@link Double} is used as wrapper for these values.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    31
 * The result value is created from text of the body of this element.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    32
 * The body parsing is described in the class {@link StringElementHandler}.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    33
 * For example:<pre>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    34
 * &lt;double&gt;1.23e45&lt;/double&gt;</pre>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    35
 * is shortcut to<pre>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    36
 * &lt;method name="valueOf" class="java.lang.Double"&gt;
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    37
 *     &lt;string&gt;1.23e45&lt;/string&gt;
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    38
 * &lt;/method&gt;</pre>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    39
 * which is equivalent to {@code Double.valueOf("1.23e45")} in Java code.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 5506
diff changeset
    40
 * <p>The following attribute is supported:
1844
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    41
 * <dl>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    42
 * <dt>id
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    43
 * <dd>the identifier of the variable that is intended to store the result
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    44
 * </dl>
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    45
 *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    46
 * @since 1.7
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    47
 *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    48
 * @author Sergey A. Malenkov
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    49
 */
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    50
final class DoubleElementHandler extends StringElementHandler {
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    51
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    52
    /**
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    53
     * Creates {@code double} value from
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    54
     * the text of the body of this element.
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    55
     *
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    56
     * @param argument  the text of the body
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    57
     * @return evaluated {@code double} value
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    58
     */
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    59
    @Override
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    60
    public Object getValue(String argument) {
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    61
        return Double.valueOf(argument);
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    62
    }
ac2cf8242428 4864117: RFE: Make XMLDecoder API more reusable
malenkov
parents:
diff changeset
    63
}