com.ibm.portal.resolver.atom
Interface AtomDateParser

public interface AtomDateParser

Parses ATOM dates according to RFC 4287:

Such date values happen to be compatible with the following specifications: [ISO.8601.1988], [W3C.NOTE-datetime-19980827], and [W3C.REC-xmlschema-2-20041028]. Example Date constructs:

 <updated>2003-12-13T18:30:02Z</updated>
 <updated>2003-12-13T18:30:02.25Z</updated>
 <updated>2003-12-13T18:30:02+01:00</updated>
 <updated>2003-12-13T18:30:02.25+01:00</updated>
 

Date values SHOULD be as accurate as possible. For example, it would be generally inappropriate for a publishing system to apply the same timestamp to several entries that were published during the course of a single day.

Since:

6.1.0

Method Summary

void	characters(char[] ch, int off, int len) Sends the next chunk of data to the parser
void	characters(java.lang.CharSequence ch, int off, int len) Sends the next chunk of data to the parser
void	characters(java.lang.String ch, int off, int len) Sends the next chunk of data to the parser
java.util.Date	finish() Finishes the parsing process and returns the parsed date.
void	reset() initializes the parser to parse a new date

Method Detail

reset

void reset()

initializes the parser to parse a new date

characters

void characters(char[] ch,
                int off,
                int len)

Sends the next chunk of data to the parser

Parameters:

ch - date buffer

off - offset into the buffer

len - length of the buffer

characters

void characters(java.lang.String ch,
                int off,
                int len)

Sends the next chunk of data to the parser

Parameters:

ch - date buffer

off - offset into the buffer

len - length of the buffer

characters

void characters(java.lang.CharSequence ch,
                int off,
                int len)

Sends the next chunk of data to the parser

Parameters:

ch - date buffer

off - offset into the buffer

len - length of the buffer

finish

java.util.Date finish()
                      throws java.io.IOException

Finishes the parsing process and returns the parsed date. The parser neeeds to be reinitialized by calling the reset() method

Returns:

the date

Throws:

java.io.IOException - if the date format is incorrect

java.lang.NumberFormatException - if the date contains non-digit characters at positions where characters would be expected