You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2024/06/16 17:21:23 UTC
(commons-net) branch master updated (d70d0108 -> 403986c7)
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/commons-net.git
from d70d0108 Use try-with-resources in example
new 1a6bc1d7 Whitespace and comment
new 403986c7 Javadoc
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../java/org/apache/commons/net/nntp/Article.java | 80 ++++++++++++++++++----
1 file changed, 68 insertions(+), 12 deletions(-)
(commons-net) 01/02: Whitespace and comment
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-net.git
commit 1a6bc1d7ca1b5eab0048044e635bb5a59b9fdd5c
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jun 16 13:14:10 2024 -0400
Whitespace and comment
---
src/main/java/org/apache/commons/net/nntp/Article.java | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/main/java/org/apache/commons/net/nntp/Article.java b/src/main/java/org/apache/commons/net/nntp/Article.java
index 42e935d4..a8638247 100644
--- a/src/main/java/org/apache/commons/net/nntp/Article.java
+++ b/src/main/java/org/apache/commons/net/nntp/Article.java
@@ -98,8 +98,8 @@ public class Article implements Threadable {
}
@Deprecated
-
public void addHeaderField(final String name, final String val) {
+ // empty
}
/**
(commons-net) 02/02: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-net.git
commit 403986c7428a3a62ed78fc1833b7a72940a36c92
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jun 16 13:21:19 2024 -0400
Javadoc
---
.../java/org/apache/commons/net/nntp/Article.java | 78 +++++++++++++++++++---
1 file changed, 67 insertions(+), 11 deletions(-)
diff --git a/src/main/java/org/apache/commons/net/nntp/Article.java b/src/main/java/org/apache/commons/net/nntp/Article.java
index a8638247..3e3c688a 100644
--- a/src/main/java/org/apache/commons/net/nntp/Article.java
+++ b/src/main/java/org/apache/commons/net/nntp/Article.java
@@ -24,9 +24,10 @@ import java.util.Collections;
import org.apache.commons.net.util.NetConstants;
/**
- * This is a class that contains the basic state needed for message retrieval and threading. With thanks to Jamie Zawinski (jwz@jwz.org)
+ * Basic state needed for message retrieval and threading. With thanks to Jamie Zawinski (jwz@jwz.org)
*/
public class Article implements Threadable {
+
/**
* Recursive method that traverses a pre-threaded graph (or tree) of connected Article objects and prints them out.
*
@@ -122,23 +123,48 @@ public class Article implements Threadable {
simplifiedSubject = null;
}
+ /**
+ * Gets the article ID.
+ *
+ * @return the article ID.
+ */
public String getArticleId() {
return articleId;
}
+ /**
+ * Gets the article number.
+ *
+ * @return the article number.
+ */
@Deprecated
public int getArticleNumber() {
return (int) articleNumber;
}
+ /**
+ * Gets the article number.
+ *
+ * @return the article number.
+ */
public long getArticleNumberLong() {
return articleNumber;
}
+ /**
+ * Gets the article date header.
+ *
+ * @return the article date header.
+ */
public String getDate() {
return date;
}
+ /**
+ * Gets the article from header.
+ *
+ * @return the article from header.
+ */
public String getFrom() {
return from;
}
@@ -155,6 +181,11 @@ public class Article implements Threadable {
return references.toArray(NetConstants.EMPTY_STRING_ARRAY);
}
+ /**
+ * Gets the article subject.
+ *
+ * @return the article subject.
+ */
public String getSubject() {
return subject;
}
@@ -183,13 +214,23 @@ public class Article implements Threadable {
articleId = string;
}
+ /**
+ * Sets the article number.
+ *
+ * @param articleNumber the article number.
+ */
@Deprecated
- public void setArticleNumber(final int a) {
- articleNumber = a;
+ public void setArticleNumber(final int articleNumber) {
+ this.articleNumber = articleNumber;
}
- public void setArticleNumber(final long l) {
- articleNumber = l;
+ /**
+ * Sets the article number.
+ *
+ * @param articleNumber the article number.
+ */
+ public void setArticleNumber(final long articleNumber) {
+ this.articleNumber = articleNumber;
}
@Override
@@ -198,12 +239,22 @@ public class Article implements Threadable {
flushSubjectCache();
}
- public void setDate(final String string) {
- date = string;
+ /**
+ * Sets the article date header.
+ *
+ * @param date the article date header.
+ */
+ public void setDate(final String date) {
+ this.date = date;
}
- public void setFrom(final String string) {
- from = string;
+ /**
+ * Sets the article from header.
+ *
+ * @param from the article from header.
+ */
+ public void setFrom(final String from) {
+ this.from = from;
}
@Override
@@ -212,8 +263,13 @@ public class Article implements Threadable {
flushSubjectCache();
}
- public void setSubject(final String string) {
- subject = string;
+ /**
+ * Sets the article subject.
+ *
+ * @param subject the article subject.
+ */
+ public void setSubject(final String subject) {
+ this.subject = subject;
}
@Override