1 /*

     2  * Copyright (c) 2009, 2015, 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  */

    25 

    26 /*

    27  * This file is available under and governed by the GNU General Public

    28  * License version 2 only, as published by the Free Software Foundation.

    29  * However, the following notice accompanied the original version of this

    30  * file:

    31  *

    32  * The MIT License

    33  *

    34  * Copyright (c) 2004-2014 Paul R. Holser, Jr.

    35  *

    36  * Permission is hereby granted, free of charge, to any person obtaining

    37  * a copy of this software and associated documentation files (the

    38  * "Software"), to deal in the Software without restriction, including

    39  * without limitation the rights to use, copy, modify, merge, publish,

    40  * distribute, sublicense, and/or sell copies of the Software, and to

    41  * permit persons to whom the Software is furnished to do so, subject to

    42  * the following conditions:

    43  *

    44  * The above copyright notice and this permission notice shall be

    45  * included in all copies or substantial portions of the Software.

    46  *

    47  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

    48  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

    49  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

    50  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

    51  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION

    52  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

    53  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    54  */

    55 

    56 package jdk.internal.joptsimple.util;

    57 

    58 import static jdk.internal.joptsimple.internal.Strings.*;

    59 

    60 /**

    61  * <p>A simple string key/string value pair.</p>

    62  *

    63  * <p>This is useful as an argument type for options whose values take on the form <kbd>key=value</kbd>, such as JVM

    64  * command line system properties.</p>

    65  *

    66  * @author <a href="mailto:pholser@alumni.rice.edu">Paul Holser</a>

    67  */

    68 public final class KeyValuePair {

    69     public final String key;

    70     public final String value;

    71 

    72     private KeyValuePair( String key, String value ) {

    73         this.key = key;

    74         this.value = value;

    75     }

    76 

    77     /**

    78      * Parses a string assumed to be of the form <kbd>key=value</kbd> into its parts.

    79      *

    80      * @param asString key-value string

    81      * @return a key-value pair

    82      * @throws NullPointerException if {@code stringRepresentation} is {@code null}

    83      */

    84     public static KeyValuePair valueOf( String asString ) {

    85         int equalsIndex = asString.indexOf( '=' );

    86         if ( equalsIndex == -1 )

    87             return new KeyValuePair( asString, EMPTY );

    88 

    89         String aKey = asString.substring( 0, equalsIndex );

    90         String aValue = equalsIndex == asString.length() - 1 ? EMPTY : asString.substring( equalsIndex + 1 );

    91 

    92         return new KeyValuePair( aKey, aValue );

    93     }

    94 

    95     @Override

    96     public boolean equals( Object that ) {

    97         if ( !( that instanceof KeyValuePair ) )

    98             return false;

    99 

   100         KeyValuePair other = (KeyValuePair) that;

   101         return key.equals( other.key ) && value.equals( other.value );

   102     }

   103 

   104     @Override

   105     public int hashCode() {

   106         return key.hashCode() ^ value.hashCode();

   107     }

   108 

   109     @Override

   110     public String toString() {

   111         return key + '=' + value;

   112     }

   113 }