org.apache.commons.net.nntp
public final class NewGroupsOrNewsQuery extends Object
You might use the class as follows:
query = new NewsGroupsOrNewsQuery(new GregorianCalendar(97, 11, 15), false); query.addDistribution("comp"); NewsgroupInfo[] newsgroups = client.listNewgroups(query);This will retrieve the list of newsgroups starting with the comp. distribution prefix created since midnight 11/15/97.
Constructor Summary | |
---|---|
NewGroupsOrNewsQuery(Calendar date, boolean gmt)
Creates a new query using the given time as a reference point.
|
Method Summary | |
---|---|
void | addDistribution(String distribution)
Add a distribution group to the query. |
void | addNewsgroup(String newsgroup)
Add a newsgroup to the list of newsgroups being queried. |
String | getDate()
Return the NNTP query formatted date (year, month, day in the form
YYMMDD.
|
String | getDistributions()
Return the comma separated list of distributions. |
String | getNewsgroups()
Return the comma separated list of newsgroups. |
String | getTime()
Return the NNTP query formatted time (hour, minutes, seconds in the form
HHMMSS.
|
boolean | isGMT()
Return whether or not the query date should be treated as GMT.
|
void | omitNewsgroup(String newsgroup)
Add a newsgroup to the list of newsgroups being queried, but indicate
that group should not be checked for new news. |
Parameters: date The date since which new groups or news have arrived. gmt True if the date should be considered as GMT, false if not.
Parameters: distribution A distribution to add to the query.
*
wildcard, as in
comp.lang.*
or comp.lang.java.*
. Adding
at least one newsgroup is mandatory for the NEWNEWS command.
Parameters: newsgroup The newsgroup to add to the list of groups to be checked for new news.
Returns: The NNTP query formatted date.
Returns: The list of distributions, which may be null if no distributions have been specified.
Returns: The list of newsgroups, which may be null if no newsgroups have been specified.
Returns: The NNTP query formatted time.
Returns: True if the query date is to be treated as GMT, false if not.
*
wildcard, as in
comp.lang.*
or comp.lang.java.*
.
The following would create a query that searched for new news in all comp.lang.java newsgroups except for comp.lang.java.advocacy.
query.addNewsgroup("comp.lang.java.*"); query.omitNewsgroup("comp.lang.java.advocacy");
Parameters: newsgroup The newsgroup to add to the list of groups to be checked for new news, but which should be omitted from the search for new news..