|
Jive Forums API (5.5.20.2-oracle) Developer Javadocs | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface NewsGroup
Represents an NNTP news group allowing the retreival of group information and group content information.
The NewsGroup interface is one of the three primary interfaces (NewsGroup, Article and NewsGroupProvider) that backend storage providers must implement.
Article
Method Summary | |
---|---|
Article |
getArticle(int articleNumber)
Obtain an article by it's group number. |
int |
getArticleCount()
Obtain an estimate on the number of articles in the group. |
java.lang.String |
getDescription()
Obtain the bried summary description of the group. |
int |
getFirstArticleNumber()
Obtain the first valid group article number in this group. |
long |
getID()
Retruns the ID of the newsgroup. |
int |
getLastArticleNumber()
Obtain the last valid group article number in this group. |
java.lang.String |
getName()
Returns the name of the group. |
boolean |
isModerated()
Returns true if the news group is moderated. |
Method Detail |
---|
long getID()
java.lang.String getName()
Returns the name of the group.
Groups are described using unique dot separated heirchical names. Group names may not contain whitespace or non-ASCII characters. Standard open NNTP systems use comp, alt, news, rec, etc prefixes. Private news servers tend to prefix the names with a company name. E.g.:
jive.general
jive.support
jive.products.forums
jive.products.kb
java.lang.String getDescription()
Obtain the bried summary description of the group.
Provides a brief description of the news group. NNTP limits line lengths to 512 ASCII characters including the trailing <CR-LF> terminator. Thus there are 510 characters for a line. So the group name + 1 space character, plus the description must equal 510 characters. If the description exceeds this length, the server will truncate the description to fit.
boolean isModerated()
Returns true if the news group is moderated.
Moderated news groups allow posting, but articles are sent to a moderator who must approve the articles before they appear in their group(s).
int getFirstArticleNumber()
Obtain the first valid group article number in this group.
int getLastArticleNumber()
Obtain the last valid group article number in this group.
int getArticleCount()
Obtain an estimate on the number of articles in the group.
This count does not have to be 100% accurate and can be simply the difference between the last and first group number. However, if the server can provide more accurate numbers it will provide a more consistent user experience. Otherwise, the group summary will show one number, but when the reader actually downloads the articles that number will change to reflect the actual count.
Article getArticle(int articleNumber) throws ArticleNotFoundException
Obtain an article by it's group number.
articleNumber
- the group's article number.
ArticleNotFoundException
- if no article corresponds to the given number.
|
Jive Forums Project Page | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |