Apache
/
hadoop
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HDFS-2658. HttpFS introduced 70 javadoc warnings. (tucu) 

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/trunk@1220810 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Alejandro Abdelnur 2011-12-19 15:53:53 +00:00
parent 5e185702ea
commit de928a4aa0
7 changed files with 35 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
dev-support/test-patch.properties
View File

@ -18,4 +18,4 @@
OK_RELEASEAUDIT_WARNINGS=0 OK_RELEASEAUDIT_WARNINGS=0
OK_FINDBUGS_WARNINGS=0 OK_FINDBUGS_WARNINGS=0
OK_JAVADOC_WARNINGS=6 OK_JAVADOC_WARNINGS=8

2
hadoop-hdfs-project/dev-support/test-patch.properties
View File

@ -18,4 +18,4 @@
OK_RELEASEAUDIT_WARNINGS=0 OK_RELEASEAUDIT_WARNINGS=0
OK_FINDBUGS_WARNINGS=0 OK_FINDBUGS_WARNINGS=0
OK_JAVADOC_WARNINGS=0 OK_JAVADOC_WARNINGS=2

2
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/main/java/org/apache/hadoop/fs/http/server/HttpFSParams.java
View File

@ -228,8 +228,6 @@ public class HttpFSParams {
* <p/> * <p/>
* This is required because JAX-RS resolution of paths does not add * This is required because JAX-RS resolution of paths does not add
* the root '/'. * the root '/'.
*
* @returns absolute path.
*/ */
public void makeAbsolute() { public void makeAbsolute() {
String path = value(); String path = value();

56
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/main/java/org/apache/hadoop/fs/http/server/HttpFSServer.java
View File

@ -92,9 +92,9 @@ public class HttpFSServer {
* Special binding for '/' as it is not handled by the wildcard binding. * Special binding for '/' as it is not handled by the wildcard binding.
* *
* @param user principal making the request. * @param user principal making the request.
* @param op GET operation, default value is {@link HttpFSFileSystem.GetOpValues#OPEN}. * @param op GET operation, default value is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#OPEN}.
* @param filter Glob filter, default value is none. Used only if the * @param filter Glob filter, default value is none. Used only if the
* operation is {@link HttpFSFileSystem.GetOpValues#LISTSTATUS} * operation is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#LISTSTATUS}
* @param doAs user being impersonated, defualt value is none. It can be used * @param doAs user being impersonated, defualt value is none. It can be used
* only if the current user is a HttpFSServer proxyuser. * only if the current user is a HttpFSServer proxyuser.
* *
@ -202,31 +202,31 @@ public class HttpFSServer {
/** /**
* Binding to handle all GET requests, supported operations are * Binding to handle all GET requests, supported operations are
* {@link HttpFSFileSystem.GetOpValues}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues}.
* <p/> * <p/>
* The {@link HttpFSFileSystem.GetOpValues#INSTRUMENTATION} operation is available only * The @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#INSTRUMENTATION} operation is available only
* to users that are in HttpFSServer's admin group (see {@link HttpFSServer}. It returns * to users that are in HttpFSServer's admin group (see {@link HttpFSServer}. It returns
* HttpFSServer instrumentation data. The specified path must be '/'. * HttpFSServer instrumentation data. The specified path must be '/'.
* *
* @param user principal making the request. * @param user principal making the request.
* @param path path for the GET request. * @param path path for the GET request.
* @param op GET operation, default value is {@link HttpFSFileSystem.GetOpValues#OPEN}. * @param op GET operation, default value is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#OPEN}.
* @param offset of the file being fetch, used only with * @param offset of the file being fetch, used only with
* {@link HttpFSFileSystem.GetOpValues#OPEN} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#OPEN} operations.
* @param len amounts of bytes, used only with {@link HttpFSFileSystem.GetOpValues#OPEN} * @param len amounts of bytes, used only with @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#OPEN}
* operations. * operations.
* @param filter Glob filter, default value is none. Used only if the * @param filter Glob filter, default value is none. Used only if the
* operation is {@link HttpFSFileSystem.GetOpValues#LISTSTATUS} * operation is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.GetOpValues#LISTSTATUS}
* @param doAs user being impersonated, defualt value is none. It can be used * @param doAs user being impersonated, defualt value is none. It can be used
* only if the current user is a HttpFSServer proxyuser. * only if the current user is a HttpFSServer proxyuser.
* @param override, default is true. Used only for * @param override, default is true. Used only for
* {@link HttpFSFileSystem.PutOpValues#CREATE} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#CREATE} operations.
* @param blockSize block size to set, used only by * @param blockSize block size to set, used only by
* {@link HttpFSFileSystem.PutOpValues#CREATE} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#CREATE} operations.
* @param permission permission to set, used only by * @param permission permission to set, used only by
* {@link HttpFSFileSystem.PutOpValues#SETPERMISSION}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETPERMISSION}.
* @param replication replication factor to set, used only by * @param replication replication factor to set, used only by
* {@link HttpFSFileSystem.PutOpValues#SETREPLICATION}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETREPLICATION}.
* *
* @return the request response. * @return the request response.
* *
@ -361,7 +361,7 @@ public class HttpFSServer {
* *
* @param user principal making the request. * @param user principal making the request.
* @param path path for the DELETE request. * @param path path for the DELETE request.
* @param op DELETE operation, default value is {@link HttpFSFileSystem.DeleteOpValues#DELETE}. * @param op DELETE operation, default value is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.DeleteOpValues#DELETE}.
* @param recursive indicates if the delete is recursive, default is <code>false</code> * @param recursive indicates if the delete is recursive, default is <code>false</code>
* @param doAs user being impersonated, defualt value is none. It can be used * @param doAs user being impersonated, defualt value is none. It can be used
* only if the current user is a HttpFSServer proxyuser. * only if the current user is a HttpFSServer proxyuser.
@ -404,33 +404,33 @@ public class HttpFSServer {
/** /**
* Binding to handle all PUT requests, supported operations are * Binding to handle all PUT requests, supported operations are
* {@link HttpFSFileSystem.PutOpValues}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues}.
* *
* @param is request input stream, used only for * @param is request input stream, used only for
* {@link HttpFSFileSystem.PostOpValues#APPEND} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PostOpValues#APPEND} operations.
* @param user principal making the request. * @param user principal making the request.
* @param uriInfo the request uriInfo. * @param uriInfo the request uriInfo.
* @param path path for the PUT request. * @param path path for the PUT request.
* @param op PUT operation, no default value. * @param op PUT operation, no default value.
* @param toPath new path, used only for * @param toPath new path, used only for
* {@link HttpFSFileSystem.PutOpValues#RENAME} operations. * {@link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#RENAME} operations.
* {@link HttpFSFileSystem.PutOpValues#SETTIMES}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETTIMES}.
* @param owner owner to set, used only for * @param owner owner to set, used only for
* {@link HttpFSFileSystem.PutOpValues#SETOWNER} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETOWNER} operations.
* @param group group to set, used only for * @param group group to set, used only for
* {@link HttpFSFileSystem.PutOpValues#SETOWNER} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETOWNER} operations.
* @param override, default is true. Used only for * @param override, default is true. Used only for
* {@link HttpFSFileSystem.PutOpValues#CREATE} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#CREATE} operations.
* @param blockSize block size to set, used only by * @param blockSize block size to set, used only by
* {@link HttpFSFileSystem.PutOpValues#CREATE} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#CREATE} operations.
* @param permission permission to set, used only by * @param permission permission to set, used only by
* {@link HttpFSFileSystem.PutOpValues#SETPERMISSION}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETPERMISSION}.
* @param replication replication factor to set, used only by * @param replication replication factor to set, used only by
* {@link HttpFSFileSystem.PutOpValues#SETREPLICATION}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETREPLICATION}.
* @param modifiedTime modified time, in seconds since EPOC, used only by * @param modifiedTime modified time, in seconds since EPOC, used only by
* {@link HttpFSFileSystem.PutOpValues#SETTIMES}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETTIMES}.
* @param accessTime accessed time, in seconds since EPOC, used only by * @param accessTime accessed time, in seconds since EPOC, used only by
* {@link HttpFSFileSystem.PutOpValues#SETTIMES}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PutOpValues#SETTIMES}.
* @param hasData indicates if the append request is uploading data or not * @param hasData indicates if the append request is uploading data or not
* (just getting the handle). * (just getting the handle).
* @param doAs user being impersonated, defualt value is none. It can be used * @param doAs user being impersonated, defualt value is none. It can be used
@ -547,14 +547,14 @@ public class HttpFSServer {
/** /**
* Binding to handle all OPST requests, supported operations are * Binding to handle all OPST requests, supported operations are
* {@link HttpFSFileSystem.PostOpValues}. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PostOpValues}.
* *
* @param is request input stream, used only for * @param is request input stream, used only for
* {@link HttpFSFileSystem.PostOpValues#APPEND} operations. * @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PostOpValues#APPEND} operations.
* @param user principal making the request. * @param user principal making the request.
* @param uriInfo the request uriInfo. * @param uriInfo the request uriInfo.
* @param path path for the POST request. * @param path path for the POST request.
* @param op POST operation, default is {@link HttpFSFileSystem.PostOpValues#APPEND}. * @param op POST operation, default is @link org.apache.hadoop.fs.http.client.HttpFSFileSystem.PostOpValues#APPEND}.
* @param hasData indicates if the append request is uploading data or not (just getting the handle). * @param hasData indicates if the append request is uploading data or not (just getting the handle).
* @param doAs user being impersonated, defualt value is none. It can be used * @param doAs user being impersonated, defualt value is none. It can be used
* only if the current user is a HttpFSServer proxyuser. * only if the current user is a HttpFSServer proxyuser.

4
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/main/java/org/apache/hadoop/lib/lang/RunnableCallable.java
View File

@ -68,9 +68,7 @@ public class RunnableCallable implements Callable<Void>, Runnable {
/** /**
* Invokes the wrapped callable/runnable as a runnable. * Invokes the wrapped callable/runnable as a runnable.
* *
* @return void * @throws RuntimeException thrown by the wrapped callable/runnable invocation.
*
* @throws Exception thrown by the wrapped callable/runnable invocation.
*/ */
@Override @Override
public void run() { public void run() {

4
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/main/java/org/apache/hadoop/lib/server/Server.java
View File

@ -251,7 +251,7 @@ public class Server {
* The status must be settable. * The status must be settable.
* <p/> * <p/>
* All services will be notified o the status change via the * All services will be notified o the status change via the
* {@link Service#serverStatusChange(Status, Status)} method. If a service * {@link Service#serverStatusChange(Server.Status, Server.Status)} method. If a service
* throws an exception during the notification, the server will be destroyed. * throws an exception during the notification, the server will be destroyed.
* *
* @param status status to set. * @param status status to set.
@ -703,7 +703,7 @@ public class Server {
/** /**
* Returns the server configuration. * Returns the server configuration.
* *
* @return * @return the server configuration.
*/ */
public Configuration getConfig() { public Configuration getConfig() {
return config; return config;

2
hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
View File

@ -178,6 +178,8 @@ Trunk (unreleased changes)
HDFS-2700. Fix failing TestDataNodeMultipleRegistrations in trunk HDFS-2700. Fix failing TestDataNodeMultipleRegistrations in trunk
(Uma Maheswara Rao G via todd) (Uma Maheswara Rao G via todd)
HDFS-2658. HttpFS introduced 70 javadoc warnings. (tucu)
Release 0.23.1 - UNRELEASED Release 0.23.1 - UNRELEASED
INCOMPATIBLE CHANGES INCOMPATIBLE CHANGES