org.datanucleus.store.types.simple

Class SqlTimestamp

java.lang.Object

java.util.Date

java.sql.Timestamp

org.datanucleus.store.types.simple.SqlTimestamp

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>, SCO

public class SqlTimestamp
extends Timestamp
implements SCO

A mutable second-class SQL timestamp object.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected AbstractMemberMetaData	ownerMmd
protected ObjectProvider	ownerOP

Constructor Summary

Constructors

Constructor and Description
SqlTimestamp(ObjectProvider op, AbstractMemberMetaData mmd) Creates a SqlTimestamp object that represents the time at which it was allocated.

Method Summary

Methods

Modifier and Type	Method and Description
void	attachCopy(Object value) Method to return an attached version for the passed ObjectProvider and field, using the passed value.
Object	clone() Creates and returns a copy of this object.
Object	detachCopy(FetchPlanState state) Method to detach a copy of this object.
String	getFieldName() Accessor for the field name
Object	getOwner() Accessor for the owner.
Object	getValue() Accessor for the unwrapped value that we are wrapping.
void	initialise() Method to initialise the SCO for use.
void	initialise(Object o, boolean forInsert, boolean forUpdate) Method to initialise the SCO from an existing value.
void	makeDirty() Utility to mark the object as dirty
void	setDate(int date) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).
void	setHours(int hours) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.HOUR_OF_DAY, int hours).
void	setMinutes(int minutes) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MINUTE, int minutes).
void	setMonth(int month) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).
void	setNanos(int time_nanos) Mutator for the time in nanos.
void	setSeconds(int seconds) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.SECOND, int seconds).
void	setTime(long time) Mutator for the time.
void	setYear(int year) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).
void	unsetOwner() Utility to unset the owner.
protected Object	writeReplace() The writeReplace method is called when ObjectOutputStream is preparing to write the object to the stream.

Methods inherited from class java.sql.Timestamp

after, before, compareTo, compareTo, equals, equals, getNanos, getTime, hashCode, toString, valueOf

Methods inherited from class java.util.Date

after, before, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

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

Field Detail

ownerOP

protected transient ObjectProvider ownerOP

ownerMmd

protected transient AbstractMemberMetaData ownerMmd

Constructor Detail

SqlTimestamp

public SqlTimestamp(ObjectProvider op,
            AbstractMemberMetaData mmd)

Creates a SqlTimestamp object that represents the time at which it was allocated.

Parameters:

op - ObjectProvider for the owning object

mmd - Metadata for the member

Method Detail

initialise

public void initialise()

Method to initialise the SCO for use.

Specified by:

initialise in interface SCO

initialise

public void initialise(Object o,
              boolean forInsert,
              boolean forUpdate)

Method to initialise the SCO from an existing value.

Specified by:

initialise in interface SCO

Parameters:

o - The Object

forInsert - Whether the object needs inserting in the datastore with this value

forUpdate - Whether to update the datastore with this value

getValue

public Object getValue()

Accessor for the unwrapped value that we are wrapping.

Specified by:

getValue in interface SCO

Returns:

The unwrapped value

unsetOwner

public void unsetOwner()

Utility to unset the owner.

Specified by:

unsetOwner in interface SCO

getOwner

public Object getOwner()

Accessor for the owner.

Specified by:

getOwner in interface SCO

Returns:

The owner

getFieldName

public String getFieldName()

Accessor for the field name

Specified by:

getFieldName in interface SCO

Returns:

The field name

makeDirty

public void makeDirty()

Utility to mark the object as dirty

detachCopy

public Object detachCopy(FetchPlanState state)

Method to detach a copy of this object.

Specified by:

detachCopy in interface SCO

Parameters:

state - State for detachment process

Returns:

The detached object

attachCopy

public void attachCopy(Object value)

Method to return an attached version for the passed ObjectProvider and field, using the passed value.

Specified by:

attachCopy in interface SCO

Parameters:

value - The new value

clone

public Object clone()

Creates and returns a copy of this object.

Mutable second-class Objects are required to provide a public clone method in order to allow for copying PersistenceCapable objects. In contrast to Object.clone(), this method must not throw a CloneNotSupportedException.

Specified by:

clone in interface SCO

Overrides:

clone in class Date

Returns:

A clone of the object

setTime

public void setTime(long time)

Mutator for the time.

Overrides:

setTime in class Timestamp

Parameters:

time - The time (millisecs)

setNanos

public void setNanos(int time_nanos)

Mutator for the time in nanos.

Overrides:

setNanos in class Timestamp

Parameters:

time_nanos - The time (nanos)

setYear

public void setYear(int year)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).

Sets the year of this Date object to be the specified value plus 1900. This Date object is modified so that it represents a point in time within the specified year, with the month, date, hour, minute, and second the same as before, as interpreted in the local time zone. (Of course, if the date was February 29, for example, and the year is set to a non-leap year, then the new date will be treated as if it were on March 1.)

Overrides:

setYear in class Date

Parameters:

year - the year value.

See Also:

Calendar

setMonth

public void setMonth(int month)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).

Sets the month of this date to the specified value. This Date object is modified so that it represents a point in time within the specified month, with the year, date, hour, minute, and second the same as before, as interpreted in the local time zone. If the date was October 31, for example, and the month is set to June, then the new date will be treated as if it were on July 1, because June has only 30 days.

Overrides:

setMonth in class Date

Parameters:

month - the month value between 0-11.

See Also:

Calendar

setDate

public void setDate(int date)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).

Sets the day of the month of this Date object to the specified value. This Date object is modified so that it represents a point in time within the specified day of the month, with the year, month, hour, minute, and second the same as before, as interpreted in the local time zone. If the date was April 30, for example, and the date is set to 31, then it will be treated as if it were on May 1, because April has only 30 days.

Overrides:

setDate in class Date

Parameters:

date - the day of the month value between 1-31.

See Also:

Calendar

setHours

public void setHours(int hours)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.HOUR_OF_DAY, int hours).

Sets the hour of this Date object to the specified value. This Date object is modified so that it represents a point in time within the specified hour of the day, with the year, month, date, minute, and second the same as before, as interpreted in the local time zone.

Overrides:

setHours in class Date

Parameters:

hours - the hour value.

See Also:

Calendar

setMinutes

public void setMinutes(int minutes)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MINUTE, int minutes).

Sets the minutes of this Date object to the specified value. This Date object is modified so that it represents a point in time within the specified minute of the hour, with the year, month, date, hour, and second the same as before, as interpreted in the local time zone.

Overrides:

setMinutes in class Date

Parameters:

minutes - the value of the minutes.

See Also:

Calendar

setSeconds

public void setSeconds(int seconds)

Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.SECOND, int seconds).

Sets the seconds of this Date to the specified value. This Date object is modified so that it represents a point in time within the specified second of the minute, with the year, month, date, hour, and minute the same as before, as interpreted in the local time zone.

Overrides:

setSeconds in class Date

Parameters:

seconds - the seconds value.

See Also:

Calendar

writeReplace

protected Object writeReplace()
                       throws ObjectStreamException

The writeReplace method is called when ObjectOutputStream is preparing to write the object to the stream. The ObjectOutputStream checks whether the class defines the writeReplace method. If the method is defined, the writeReplace method is called to allow the object to designate its replacement in the stream. The object returned should be either of the same type as the object passed in or an object that when read and resolved will result in an object of a type that is compatible with all references to the object.

Returns:

the replaced object

Throws:

ObjectStreamException