com.asakusafw.runtime.value

Class LongOption

java.lang.Object

com.asakusafw.runtime.value.ValueOption<LongOption>

com.asakusafw.runtime.value.LongOption

All Implemented Interfaces:

WritableRawComparable, Restorable, Comparable<WritableRawComparable>, org.apache.hadoop.io.Writable, org.apache.hadoop.io.WritableComparable<WritableRawComparable>

public final class LongOption
extends ValueOption<LongOption>

Represents a long value which can be null.

Field Summary

Fields inherited from class com.asakusafw.runtime.value.ValueOption

nullValue

Constructor Summary

Constructors

Constructor and Description
LongOption() Creates a new instance which represents null value.
LongOption(long value) Creates a new instance which represents the specified value.

Method Summary

Modifier and Type	Method and Description
void	add(long delta) Adds a value into this object.
void	add(LongOption other) Adds a value into this object.
static int	compareBytes(byte[] b1, int s1, int l1, byte[] b2, int s2, int l2) Compares between the two objects in serialized form.
int	compareInBytes(byte[] b1, int o1, byte[] b2, int o2) Compares two objects in bytes.
int	compareTo(WritableRawComparable o)
void	copyFrom(LongOption optionOrNull) Deprecated.
boolean	equals(Object obj)
long	get() Returns the value which this object represents.
static int	getBytesLength(byte[] bytes, int offset, int length) Returns the actual number of bytes from the serialized byte array.
int	getSizeInBytes(byte[] buf, int offset) Computes and returns size in bytes.
boolean	has(long other) Returns whether both this object and the specified value represents an equivalent value or not.
int	hashCode()
LongOption	modify(long newValue) Deprecated. Application developer should not use this method directly
long	or(long alternate) Returns the value which this object represents.
void	readFields(DataInput in)
int	restore(byte[] bytes, int offset, int limit) Restores the contents from the slice of the byte array.
String	toString()
void	write(DataOutput out)

Methods inherited from class com.asakusafw.runtime.value.ValueOption

isNull, isPresent, max, min, orOption, setNull

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LongOption

public LongOption()

Creates a new instance which represents null value.

LongOption

public LongOption(long value)

Creates a new instance which represents the specified value.

Parameters:

value - the initial value

Method Detail

get

public long get()

Returns the value which this object represents.

Returns:

the value which this object represents, never null

Throws:

NullPointerException - if this object represents null

or

public long or(long alternate)

Returns the value which this object represents.

Parameters:

alternate - the alternative value for null

Returns:

the value which this object represents, or the alternative one if this object represents null

add

public void add(long delta)

Adds a value into this object.

Parameters:

delta - the value to be add

Throws:

NullPointerException - if this object represents null

add

public void add(LongOption other)

Adds a value into this object.

Parameters:

other - the value to be add, or null to do nothing

Throws:

NullPointerException - if this object represents null

modify

@Deprecated
public LongOption modify(long newValue)

Deprecated. Application developer should not use this method directly

Sets the value.

Parameters:

newValue - the value (nullable)

Returns:

this

See Also:

ValueOption.setNull()

copyFrom

@Deprecated
public void copyFrom(LongOption optionOrNull)

Deprecated.

Description copied from class: ValueOption

Copies the value from the specified values into this.

Specified by:

copyFrom in class ValueOption<LongOption>

Parameters:

optionOrNull - the source object, or null to make this value represent null

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

has

public boolean has(long other)

Returns whether both this object and the specified value represents an equivalent value or not.

Parameters:

other - the target value

Returns:

true if this object has the specified value, otherwise false

compareTo

public int compareTo(WritableRawComparable o)

toString

public String toString()

Overrides:

toString in class Object

write

public void write(DataOutput out)
           throws IOException

Throws:

IOException

readFields

public void readFields(DataInput in)
                throws IOException

Throws:

IOException

restore

public int restore(byte[] bytes,
                   int offset,
                   int limit)
            throws IOException

Description copied from interface: Restorable

Restores the contents from the slice of the byte array.

Parameters:

bytes - the byte array

offset - the beginning index in the byte array (inclusive)

limit - the ending index in the byte array (exclusive)

Returns:

the number of bytes to restore the contents

Throws:

IOException - if failed to restore the contents

getSizeInBytes

public int getSizeInBytes(byte[] buf,
                          int offset)
                   throws IOException

Description copied from interface: WritableRawComparable

Computes and returns size in bytes.

Parameters:

buf - bytes array

offset - bytes offset

Returns:

size in bytes

Throws:

IOException - if failed to compute size

compareInBytes

public int compareInBytes(byte[] b1,
                          int o1,
                          byte[] b2,
                          int o2)
                   throws IOException

Description copied from interface: WritableRawComparable

Compares two objects in bytes.

Parameters:

b1 - bytes representation of the first object

o1 - offset of the first object

b2 - bytes representation of the second object

o2 - offset of the second object

Returns:

the comparison result

Throws:

IOException - if failed to comparison

getBytesLength

public static int getBytesLength(byte[] bytes,
                                 int offset,
                                 int length)

Returns the actual number of bytes from the serialized byte array.

Parameters:

bytes - the target byte array

offset - the beginning index in the byte array (inclusive)

length - the limit length of the byte array

Returns:

the comparison result

compareBytes

public static int compareBytes(byte[] b1,
                               int s1,
                               int l1,
                               byte[] b2,
                               int s2,
                               int l2)

Compares between the two objects in serialized form.

Parameters:

b1 - the first byte array to be compared

s1 - the beginning index in b1

l1 - the limit byte size in b1

b2 - the second byte array to be compared

s2 - the beginning index in b2

l2 - the limit byte size in b2

Returns:

the comparison result