File	Doc	Category	Size	Date	Package
NewGroupsOrNewsQuery.java	API Doc	Apache Commons NET 1.4.1 API	8224	Sat Dec 03 10:05:50 GMT 2005	org.apache.commons.net.nntp

NewGroupsOrNewsQuery

• java.lang.Object

query = new NewsGroupsOrNewsQuery(new GregorianCalendar(97, 11, 15), false);
query.addDistribution("comp");
NewsgroupInfo[] newsgroups = client.listNewgroups(query);

Fields Summary
private String	__date
private String	__time
private StringBuffer	__distributions
private StringBuffer	__newsgroups
private boolean	__isGMT

Constructors Summary

public NewGroupsOrNewsQuery(Calendar date, boolean gmt) Creates a new query using the given time as a reference point. param date The date since which new groups or news have arrived. param gmt True if the date should be considered as GMT, false if not. int num; String str; StringBuffer buffer; __distributions = null; __newsgroups = null; __isGMT = gmt; buffer = new StringBuffer(); // Get year num = date.get(Calendar.YEAR); str = Integer.toString(num); num = str.length(); if (num >= 2) buffer.append(str.substring(num - 2)); else buffer.append("00"); // Get month num = date.get(Calendar.MONTH) + 1; str = Integer.toString(num); num = str.length(); if (num == 1) { buffer.append('0"); buffer.append(str); } else if (num == 2) buffer.append(str); else buffer.append("01"); // Get day num = date.get(Calendar.DAY_OF_MONTH); str = Integer.toString(num); num = str.length(); if (num == 1) { buffer.append('0"); buffer.append(str); } else if (num == 2) buffer.append(str); else buffer.append("01"); __date = buffer.toString(); buffer.setLength(0); // Get hour num = date.get(Calendar.HOUR_OF_DAY); str = Integer.toString(num); num = str.length(); if (num == 1) { buffer.append('0"); buffer.append(str); } else if (num == 2) buffer.append(str); else buffer.append("00"); // Get minutes num = date.get(Calendar.MINUTE); str = Integer.toString(num); num = str.length(); if (num == 1) { buffer.append('0"); buffer.append(str); } else if (num == 2) buffer.append(str); else buffer.append("00"); // Get seconds num = date.get(Calendar.SECOND); str = Integer.toString(num); num = str.length(); if (num == 1) { buffer.append('0"); buffer.append(str); } else if (num == 2) buffer.append(str); else buffer.append("00"); __time = buffer.toString();

Methods Summary
public void	addDistribution(java.lang.String distribution) Add a distribution group to the query. The distribution part of a newsgroup is the segment of the name preceding the first dot (e.g., comp, alt, rec). Only those newsgroups matching one of the distributions or, in the case of NEWNEWS, an article in a newsgroup matching one of the distributions, will be reported as a query result. Adding distributions is purely optional. param distribution A distribution to add to the query. if (__distributions != null) __distributions.append(',"); else __distributions = new StringBuffer(); __distributions.append(distribution);
public void	addNewsgroup(java.lang.String newsgroup) Add a newsgroup to the list of newsgroups being queried. Newsgroups added this way are only meaningful to the NEWNEWS command. Newsgroup names may include the * wildcard, as in comp.lang.* or comp.lang.java.* . Adding at least one newsgroup is mandatory for the NEWNEWS command. param newsgroup The newsgroup to add to the list of groups to be checked for new news. if (__newsgroups != null) __newsgroups.append(',"); else __newsgroups = new StringBuffer(); __newsgroups.append(newsgroup);
public java.lang.String	getDate() Return the NNTP query formatted date (year, month, day in the form YYMMDD. return The NNTP query formatted date. return __date;
public java.lang.String	getDistributions() Return the comma separated list of distributions. This may be null if there are no distributions. return The list of distributions, which may be null if no distributions have been specified. return (__distributions == null ? null : __distributions.toString());
public java.lang.String	getNewsgroups() Return the comma separated list of newsgroups. This may be null if there are no newsgroups return The list of newsgroups, which may be null if no newsgroups have been specified. return (__newsgroups == null ? null : __newsgroups.toString());
public java.lang.String	getTime() Return the NNTP query formatted time (hour, minutes, seconds in the form HHMMSS. return The NNTP query formatted time. return __time;
public boolean	isGMT() Return whether or not the query date should be treated as GMT. return True if the query date is to be treated as GMT, false if not. return __isGMT;
public void	omitNewsgroup(java.lang.String newsgroup) Add a newsgroup to the list of newsgroups being queried, but indicate that group should not be checked for new news. Newsgroups added this way are only meaningful to the NEWNEWS command. Newsgroup names may include the * 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"); param 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.. addNewsgroup("!" + newsgroup);