com.guiseframework.converter
Class TelephoneNumberStringLiteralConverter

java.lang.Object
  com.globalmentor.beans.BoundPropertyObject
      com.guiseframework.event.GuiseBoundPropertyObject
          com.guiseframework.converter.AbstractConverter<V,java.lang.String>
              com.guiseframework.converter.AbstractStringLiteralConverter<com.globalmentor.itu.TelephoneNumber>
                  com.guiseframework.converter.TelephoneNumberStringLiteralConverter

All Implemented Interfaces:

com.globalmentor.beans.PropertyBindable, com.globalmentor.beans.PropertyConstrainable, Converter<com.globalmentor.itu.TelephoneNumber,java.lang.String>

public class TelephoneNumberStringLiteralConverter
extends AbstractStringLiteralConverter<com.globalmentor.itu.TelephoneNumber>

A converter that converts a TelephoneNumber from and to a string literal. If a default country code is specified, that country code will be used as the default telephone country code. Otherwise, the country code of the current local's country, if available, will be used as the default telephone country code.

Author:

Garret Wilson

See Also:

GuiseSession.getLocale(), CountryCode.getCountryCode(Locale)

Field Summary

Fields inherited from class com.globalmentor.beans.BoundPropertyObject

NO_PROPERTY_CHANGE_LISTENERS, NO_VETOABLE_CHANGE_LISTENERS

Fields inherited from interface com.guiseframework.converter.Converter

INVALID_VALUE_MESSAGE_PROPERTY

Constructor Summary

TelephoneNumberStringLiteralConverter()
Default constructor.

TelephoneNumberStringLiteralConverter(com.globalmentor.itu.CountryCode defaultCC)
Default country code constructor.

TelephoneNumberStringLiteralConverter(int defaultCC)
Default country code constructor.

Method Summary

com.globalmentor.itu.TelephoneNumber	convertLiteral(java.lang.String literal) Converts a literal representation of a value from the lexical space into a value in the value space.
int	getDefaultCC()

Methods inherited from class com.guiseframework.converter.AbstractStringLiteralConverter

convertValue, getInstance

Methods inherited from class com.guiseframework.converter.AbstractConverter

getInvalidValueMessage, isEquivalent, isValidLiteral, setInvalidValueMessage

Methods inherited from class com.guiseframework.event.GuiseBoundPropertyObject

getSession

Methods inherited from class com.globalmentor.beans.BoundPropertyObject

addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, createPostponedPropertyChangeEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getForwardPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeSupport, getRepeatPropertyChangeListener, getRepeatVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, getVetoableChangeSupport, hasPropertyChangeListeners, hasVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.guiseframework.converter.Converter

getSession

Methods inherited from interface com.globalmentor.beans.PropertyBindable

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, hasPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

TelephoneNumberStringLiteralConverter

public TelephoneNumberStringLiteralConverter()

Default constructor. The country code of the current local's country, if available, will be used as the default telephone country code when each telephone number is created.

TelephoneNumberStringLiteralConverter

public TelephoneNumberStringLiteralConverter(com.globalmentor.itu.CountryCode defaultCC)

Default country code constructor.

Parameters:

defaultCC - The default country code to use when constructing telephone numbers, or null if the country code of the current local's country, if available, should be used as the default telephone country code.

TelephoneNumberStringLiteralConverter

public TelephoneNumberStringLiteralConverter(int defaultCC)

Default country code constructor.

Parameters:

defaultCC - The default country code to use when constructing telephone numbers, or -1 if the country code of the current local's country, if available, should be used as the default telephone country code.

Method Detail

getDefaultCC

public int getDefaultCC()

Returns:

The default country code, or -1 if the country code of the current local's country, if available, should be used as the default telephone country code.

convertLiteral

public com.globalmentor.itu.TelephoneNumber convertLiteral(java.lang.String literal)
                                                    throws ConversionException

Converts a literal representation of a value from the lexical space into a value in the value space. If a default country code is specified, that country code will be used as the default telephone country code. Otherwise, the country code of the current local's country, if available, will be used as the default telephone country code.

Parameters:

literal - The literal value in the lexical space to convert.

Returns:

The converted value in the value space, or null if the given literal is null.

Throws:

ConversionException - if the literal value cannot be converted.