com.sun.jdo.spi.persistence.support.sqlstore.sco

Class SqlTimestamp

java.lang.Object

java.util.Date

java.sql.Timestamp

com.sun.jdo.spi.persistence.support.sqlstore.sco.SqlTimestamp

All Implemented Interfaces:

SCO, SCODate, Serializable, Cloneable, Comparable<Date>

public class SqlTimestamp
extends Timestamp
implements SCODate

A mutable 2nd class object date.

Version:

1.0

Author:

Marina Vatkina

See Also:

Timestamp, Serialized Form

Constructor Summary

Constructors

Constructor and Description
SqlTimestamp(Object owner, String fieldName) Creates a SqlTimestamp object that represents the time at which it was allocated.
SqlTimestamp(Object owner, String fieldName, long date) Creates a SqlTimestamp object that represents the given time in milliseconds.

Method Summary

Modifier and Type	Method and Description
void	applyUpdates(StateManager sm, boolean modified) Apply changes (no-op)
Object	clone() Creates and returns a copy of this object.
Object	cloneInternal() Creates and returns a copy of this object without resetting the owner and field value.
String	getFieldName() Returns the field name
Object	getOwner() Returns the owner object of the SCO instance
StateManager	makeDirty() Marks object 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 n) Sets this Timestamp object's nanos value to the given value.
void	setNanosInternal(int n) Sets the SqlTimestamp object's nanos value without notification of the Owner field.
void	setSeconds(int seconds) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.SECOND, int seconds).
void	setTime(long time) Sets the SqlTimestamp object to represent a point in time that is time milliseconds after January 1, 1970 00:00:00 GMT.
void	setTimeInternal(long time) Sets the SqlTimestamp object without notification of the Owner field.
void	setYear(int year) Deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).
void	unsetOwner() Nullifies references to the owner Object and Field NOTE: This method should be called under the locking of the owener' state manager.

Methods inherited from class java.sql.Timestamp

after, before, compareTo, compareTo, equals, equals, from, getNanos, getTime, hashCode, toInstant, toLocalDateTime, toString, valueOf, 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

Constructor Detail

SqlTimestamp

public SqlTimestamp(Object owner,
                    String fieldName)

Creates a SqlTimestamp object that represents the time at which it was allocated. Assigns owning object and field name

Parameters:

owner - the owning object

fieldName - the owning field name

SqlTimestamp

public SqlTimestamp(Object owner,
                    String fieldName,
                    long date)

Creates a SqlTimestamp object that represents the given time in milliseconds. Assigns owning object and field name

Parameters:

owner - the owning object

fieldName - the owning field name

date - the number of milliseconds

Method Detail

setTime

public void setTime(long time)

Sets the SqlTimestamp object to represent a point in time that is time milliseconds after January 1, 1970 00:00:00 GMT.

Overrides:

setTime in class Timestamp

Parameters:

time - the number of milliseconds.

See Also:

Timestamp

setNanos

public void setNanos(int n)

Sets this Timestamp object's nanos value to the given value.

Overrides:

setNanos in class Timestamp

Parameters:

n - the new fractional seconds component

Throws:

IllegalArgumentException - if the given argument is greater than 999999999 or less than 0

See Also:

Timestamp

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.

Overrides:

clone in class Date

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 SqlTimestamp object to be the specified value plus 1900.

Overrides:

setYear in class Date

Parameters:

year - the year value.

See Also:

Calendar, Timestamp

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.

Overrides:

setMonth in class Date

Parameters:

month - the month value between 0-11.

See Also:

Calendar, Timestamp

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 SqlTimestamp object to the specified value.

Overrides:

setDate in class Date

Parameters:

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

See Also:

Calendar, Timestamp

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 SqlTimestamp object to the specified value.

Overrides:

setHours in class Date

Parameters:

hours - the hour value.

See Also:

Calendar, Timestamp

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 SqlTimestamp object to the specified value.

Overrides:

setMinutes in class Date

Parameters:

minutes - the value of the minutes.

See Also:

Calendar, Timestamp

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 SqlTimestamp to the specified value.

Overrides:

setSeconds in class Date

Parameters:

seconds - the seconds value.

See Also:

Calendar, Timestamp

cloneInternal

public Object cloneInternal()

Creates and returns a copy of this object without resetting the owner and field value.

Specified by:

cloneInternal in interface SCO

setTimeInternal

public void setTimeInternal(long time)

Sets the SqlTimestamp object without notification of the Owner field. Used internaly to populate date from DB

Specified by:

setTimeInternal in interface SCODate

Parameters:

time - the number of milliseconds.

See Also:

Timestamp

setNanosInternal

public void setNanosInternal(int n)

Sets the SqlTimestamp object's nanos value without notification of the Owner field. Used internaly to populate date from DB

Parameters:

n - the new fractional seconds component

Throws:

IllegalArgumentException - if the given argument is greater than 999999999 or less than 0

See Also:

Timestamp

unsetOwner

public void unsetOwner()

Nullifies references to the owner Object and Field NOTE: This method should be called under the locking of the owener' state manager.

Specified by:

unsetOwner in interface SCO

getOwner

public Object getOwner()

Returns the owner object of the SCO instance

Specified by:

getOwner in interface SCO

Returns:

owner object

getFieldName

public String getFieldName()

Returns the field name

Specified by:

getFieldName in interface SCO

Returns:

field name as java.lang.String

makeDirty

public StateManager makeDirty()

Marks object dirty

Specified by:

makeDirty in interface SCO

Returns:

StateManager associated with the owner

applyUpdates

public void applyUpdates(StateManager sm,
                         boolean modified)

Apply changes (no-op)

Specified by:

applyUpdates in interface SCO