org.apache.commons.ssl.org.bouncycastle.asn1

Class ASN1GeneralizedTime

java.lang.Object

org.apache.commons.ssl.org.bouncycastle.asn1.ASN1Object

org.apache.commons.ssl.org.bouncycastle.asn1.ASN1Primitive

org.apache.commons.ssl.org.bouncycastle.asn1.ASN1GeneralizedTime

All Implemented Interfaces:

ASN1Encodable

Direct Known Subclasses:

DERGeneralizedTime

public class ASN1GeneralizedTime
extends ASN1Primitive

Base class representing the ASN.1 GeneralizedTime type.

The main difference between these and UTC time is a 4 digit year.

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	time

Constructor Summary

Constructors

Constructor and Description
ASN1GeneralizedTime(byte[] bytes)
ASN1GeneralizedTime(java.util.Date time) Base constructor from a java.util.date object
ASN1GeneralizedTime(java.util.Date time, java.util.Locale locale) Base constructor from a java.util.date and Locale - you may need to use this if the default locale doesn't use a Gregorian calender so that the GeneralizedTime produced is compatible with other ASN.1 implementations.
ASN1GeneralizedTime(java.lang.String time) The correct format for this is YYYYMMDDHHMMSS[.f]Z, or without the Z for local time, or Z+-HHMM on the end, for difference between local time and UTC time.

Method Summary

Modifier and Type	Method and Description
(package private) boolean	asn1Equals(ASN1Primitive o)
private java.lang.String	calculateGMTOffset()
private java.lang.String	convert(int time)
(package private) void	encode(ASN1OutputStream out)
(package private) int	encodedLength()
java.util.Date	getDate()
static ASN1GeneralizedTime	getInstance(ASN1TaggedObject obj, boolean explicit) return a Generalized Time object from a tagged object.
static ASN1GeneralizedTime	getInstance(java.lang.Object obj) return a generalized time from the passed in object
java.lang.String	getTime() return the time - always in the form of YYYYMMDDhhmmssGMT(+hh:mm|-hh:mm).
java.lang.String	getTimeString() Return the time.
private boolean	hasFractionalSeconds()
int	hashCode()
(package private) boolean	isConstructed()

Methods inherited from class org.apache.commons.ssl.org.bouncycastle.asn1.ASN1Primitive

equals, fromByteArray, toASN1Primitive, toDERObject, toDLObject

Methods inherited from class org.apache.commons.ssl.org.bouncycastle.asn1.ASN1Object

getEncoded, getEncoded, hasEncodedTagValue, toASN1Object

Methods inherited from class java.lang.Object

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

Field Detail

time

private byte[] time

Constructor Detail

ASN1GeneralizedTime

public ASN1GeneralizedTime(java.lang.String time)

The correct format for this is YYYYMMDDHHMMSS[.f]Z, or without the Z for local time, or Z+-HHMM on the end, for difference between local time and UTC time. The fractional second amount f must consist of at least one number with trailing zeroes removed.

Parameters:

time - the time string.

Throws:

java.lang.IllegalArgumentException - if String is an illegal format.

ASN1GeneralizedTime

public ASN1GeneralizedTime(java.util.Date time)

Base constructor from a java.util.date object

Parameters:

time - a date object representing the time of interest.

ASN1GeneralizedTime

public ASN1GeneralizedTime(java.util.Date time,
                           java.util.Locale locale)

Base constructor from a java.util.date and Locale - you may need to use this if the default locale doesn't use a Gregorian calender so that the GeneralizedTime produced is compatible with other ASN.1 implementations.

Parameters:

time - a date object representing the time of interest.

locale - an appropriate Locale for producing an ASN.1 GeneralizedTime value.

ASN1GeneralizedTime

ASN1GeneralizedTime(byte[] bytes)

Method Detail

getInstance

public static ASN1GeneralizedTime getInstance(java.lang.Object obj)

return a generalized time from the passed in object

Parameters:

obj - an ASN1GeneralizedTime or an object that can be converted into one.

Returns:

an ASN1GeneralizedTime instance, or null.

Throws:

java.lang.IllegalArgumentException - if the object cannot be converted.

getInstance

public static ASN1GeneralizedTime getInstance(ASN1TaggedObject obj,
                                              boolean explicit)

return a Generalized Time object from a tagged object.

Parameters:

obj - the tagged object holding the object we want

explicit - true if the object is meant to be explicitly tagged false otherwise.

Returns:

an ASN1GeneralizedTime instance.

Throws:

java.lang.IllegalArgumentException - if the tagged object cannot be converted.

getTimeString

public java.lang.String getTimeString()

Return the time.

Returns:

The time string as it appeared in the encoded object.

getTime

public java.lang.String getTime()

return the time - always in the form of YYYYMMDDhhmmssGMT(+hh:mm|-hh:mm).

Normally in a certificate we would expect "Z" rather than "GMT", however adding the "GMT" means we can just use:

     dateF = new SimpleDateFormat("yyyyMMddHHmmssz");
 

To read in the time and get a date which is compatible with our local time zone.

calculateGMTOffset

private java.lang.String calculateGMTOffset()

convert

private java.lang.String convert(int time)

getDate

public java.util.Date getDate()
                       throws java.text.ParseException

Throws:

java.text.ParseException

hasFractionalSeconds

private boolean hasFractionalSeconds()

isConstructed

boolean isConstructed()

Specified by:

isConstructed in class ASN1Primitive

encodedLength

int encodedLength()

Specified by:

encodedLength in class ASN1Primitive

encode

void encode(ASN1OutputStream out)
     throws java.io.IOException

Specified by:

encode in class ASN1Primitive

Throws:

java.io.IOException

asn1Equals

boolean asn1Equals(ASN1Primitive o)

Specified by:

asn1Equals in class ASN1Primitive

hashCode

public int hashCode()

Specified by:

hashCode in class ASN1Primitive