Package me.ahoo.cosid.converter

Class ToStringIdConverter

java.lang.Object

me.ahoo.cosid.converter.ToStringIdConverter

All Implemented Interfaces:

IdConverter, Statistical

public class ToStringIdConverter
extends Object
implements IdConverter

Converts long IDs to/from strings using standard String.valueOf().

Optionally pads the string with leading zeros to a specified length.

Field Summary

Fields

Modifier and Type	Field	Description
static final ToStringIdConverter	INSTANCE	Shared instance without padding.

Constructor Summary

Constructors

Constructor	Description
ToStringIdConverter(boolean padStart, int charSize)	Creates a converter with optional padding.

Method Summary

Modifier and Type	Method	Description
long	asLong(@NonNull String idString)	Convert a String type ID back to its long representation.
@NonNull String	asString(long id)	Convert a long type ID to its String representation.
Stat	stat()	Get statistical information about this converter.

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final ToStringIdConverter INSTANCE

Shared instance without padding.

Constructor Details

ToStringIdConverter

public ToStringIdConverter(boolean padStart,
 int charSize)

Creates a converter with optional padding.

Parameters:

padStart - whether to pad with leading zeros

charSize - the target character size for padding

Method Details

asString

public @NonNull String asString(long id)

Description copied from interface: IdConverter

Convert a long type ID to its String representation.

This method transforms a numeric ID into a string format according to the specific conversion algorithm implemented by the converter. For example, a radix converter might convert the number 12345 to "3d7".

Specified by:

asString in interface IdConverter

Parameters:

id - The long type ID to convert

Returns:

The String representation of the ID

asLong

public long asLong(@NonNull String idString)

Description copied from interface: IdConverter

Convert a String type ID back to its long representation.

This method performs the reverse operation of IdConverter.asString(long), transforming a string ID back into its original numeric form. Implementations should be able to correctly parse strings generated by their IdConverter.asString(long) method.

Specified by:

asLong in interface IdConverter

Parameters:

idString - The String type ID to convert

Returns:

The long representation of the ID

stat

public Stat stat()

Description copied from interface: IdConverter

Get statistical information about this converter.

This method provides basic statistical information about the converter, including its implementation class name.

Specified by:

stat in interface IdConverter

Specified by:

stat in interface Statistical

Returns:

Statistical information about this converter