001/*
002 * ============================================================================
003 * Copyright © 2002-2023 by Thomas Thrien.
004 * All Rights Reserved.
005 * ============================================================================
006 *
007 * Licensed to the public under the agreements of the GNU Lesser General Public
008 * License, version 3.0 (the "License"). You may obtain a copy of the License at
009 *
010 *      http://www.gnu.org/licenses/lgpl.html
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
014 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
015 * License for the specific language governing permissions and limitations
016 * under the License.
017 */
018
019package org.tquadrat.foundation.util.stringconverter;
020
021import static org.apiguardian.api.API.Status.STABLE;
022
023import java.io.Serial;
024
025import org.apiguardian.api.API;
026import org.tquadrat.foundation.annotation.ClassVersion;
027
028/**
029 *  The implementation of
030 *  {@link NumberStringConverter}
031 *  {@link java.lang.Long}.
032 *
033 *  @extauthor Thomas Thrien - thomas.thrien@tquadrat.org
034 *  @version $Id: LongStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $
035 *  @since 0.0.6
036 *
037 *  @UMLGraph.link
038 */
039@ClassVersion( sourceVersion = "$Id: LongStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $" )
040@API( status = STABLE, since = "0.0.6" )
041public final class LongStringConverter extends NumberStringConverter<Long>
042{
043        /*------------------------*\
044    ====** Static Initialisations **===========================================
045        \*------------------------*/
046    /**
047     *  The serial version UID for objects of this class: {@value}.
048     *
049     *  @hidden
050     */
051    @Serial
052    private static final long serialVersionUID = 1L;
053
054    /**
055     *  An instance of this class.
056     */
057    public static final LongStringConverter INSTANCE = new LongStringConverter();
058
059        /*--------------*\
060    ====** Constructors **=====================================================
061        \*--------------*/
062    /**
063     *  Creates a new instance of {@code LongStringConverter}.
064     */
065    public LongStringConverter() { super( long.class, Long.class ); }
066
067        /*---------*\
068    ====** Methods **==========================================================
069        \*---------*/
070    /**
071     *  {@inheritDoc}
072     */
073    @Override
074    protected final Long parseNumber( final String value ) throws NumberFormatException
075    {
076        return Long.decode( value );
077    }   //  parseNumber()
078
079    /**
080     *  This method is used by the
081     *  {@link java.util.ServiceLoader}
082     *  to obtain the instance for this
083     *  {@link org.tquadrat.foundation.lang.StringConverter}
084     *  implementation.
085     *
086     *  @return The instance for this {@code StringConverter} implementation.
087     */
088    public static final LongStringConverter provider() { return INSTANCE; }
089}
090//  class LongStringConverter
091
092/*
093 *  End of File
094 */