diff --git a/atmos/src/main/java/org/jclouds/atmosonline/saas/filters/SignRequest.java b/atmos/src/main/java/org/jclouds/atmosonline/saas/filters/SignRequest.java index 5c77aa42ea..f4df5dc97a 100644 --- a/atmos/src/main/java/org/jclouds/atmosonline/saas/filters/SignRequest.java +++ b/atmos/src/main/java/org/jclouds/atmosonline/saas/filters/SignRequest.java @@ -133,39 +133,39 @@ public class SignRequest implements HttpRequestFilter { } private void appendCanonicalizedHeaders(HttpRequest request, StringBuilder toSign) { - // TreeSet == Sorttheheadersalphabetically. + // TreeSet == Sort the headers alphabetically. Set headers = new TreeSet(request.getHeaders().keySet()); for (String header : headers) { if (header.startsWith("x-emc-")) { - // Convertallheadernamestolowercase. + // Convert all header names to lowercase. toSign.append(header.toLowerCase()).append(":"); - // Forheaderswithvaluesthatspanmultiplelines,convertthemintoonelinebyreplacingany - // newlinecharactersandextraembeddedwhitespacesinthevalue. + // For headers with values that span multiple lines, convert them into one line by replacing any + // newline characters and extra embedded white spaces in the value. for (String value : request.getHeaders().get(header)) toSign.append(value.replaceAll("\r?\n", "").replaceAll(" ", " ")).append(" "); toSign.deleteCharAt(toSign.lastIndexOf(" ")); - // Concatenateallheaderstogether,usingnewlines(\n)separatingeachheaderfromthenextone. + // Concatenate all headers together, using newlines (\n) separating each header from the next one. toSign.append("\n"); } } - // Thereshouldbenoterminatingnewlinecharacterattheendofthelastheader. + // There should be no terminating newline character at the end of the last header. if (toSign.charAt(toSign.length() - 1) == '\n') toSign.deleteCharAt(toSign.length() - 1); } @VisibleForTesting void appendHttpHeaders(HttpRequest request, StringBuilder toSign) { - // Onlythevalueisused,nottheheader - // name.Ifarequestdoesnotincludetheheader,thisisanemptystring. + // Only the value is used, not the header + // name. If a request does not include the header, this is an empty string. for (String header : new String[] { HttpHeaders.CONTENT_TYPE, "Range" }) toSign.append(valueOrEmpty(request.getHeaders().get(header)).toLowerCase()).append("\n"); - // StandardHTTPheader,inUTCformat.Onlythedatevalueisused, nottheheadername. + // Standard HTTP header, in UTC format. Only the date value is used, not the header name. toSign.append(request.getHeaders().get(HttpHeaders.DATE).iterator().next()).append("\n"); } @VisibleForTesting void appendCanonicalizedResource(HttpRequest request, StringBuilder toSign) { - // PathportionoftheHTTPrequestURI,inlowercase. + // Path portion of the HTTP request URI, in lowercase. toSign.append(request.getEndpoint().getRawPath().toLowerCase()).append("\n"); } diff --git a/atmos/src/main/java/org/jclouds/atmosonline/saas/options/ListOptions.java b/atmos/src/main/java/org/jclouds/atmosonline/saas/options/ListOptions.java index b19aa2616c..b34337939b 100644 --- a/atmos/src/main/java/org/jclouds/atmosonline/saas/options/ListOptions.java +++ b/atmos/src/main/java/org/jclouds/atmosonline/saas/options/ListOptions.java @@ -51,7 +51,7 @@ public class ListOptions extends BaseHttpRequestOptions { } /** - * themaximumnumberofitems thatshouldbereturned. Ifthisisnotspecified,thereisno + * the maximum number of items that should be returned. If this is not specified, there is no * limit. */ public ListOptions limit(int maxresults) { diff --git a/aws/extensions/jets3t/src/test/java/org/jclouds/aws/s3/jets3t/JCloudsS3ServiceLiveTest.java b/aws/extensions/jets3t/src/test/java/org/jclouds/aws/s3/jets3t/JCloudsS3ServiceLiveTest.java index 46103c081c..2cb7c8df7c 100755 --- a/aws/extensions/jets3t/src/test/java/org/jclouds/aws/s3/jets3t/JCloudsS3ServiceLiveTest.java +++ b/aws/extensions/jets3t/src/test/java/org/jclouds/aws/s3/jets3t/JCloudsS3ServiceLiveTest.java @@ -369,7 +369,7 @@ public class JCloudsS3ServiceLiveTest extends BaseBlobStoreIntegrationTest * Determine the number of Containers within the account and the total bytes stored. Since the * storage system is designed to store large amounts of data, care should be taken when - * representing the total bytes response as an integer; when possible, convert it to a 64-bit + * representing the total bytes response as an integer; when possible, convert it to a 64-bit * unsigned integer if your platform supports that primitive type. */ @HEAD @@ -117,21 +117,21 @@ public interface CloudFilesClient { * are supported with this request. *
    *
  • limit - For an integer value N, limits the number of results to at most N values.
    • - *
  • marker - Given a string value X, return Object names greater in value than the specied + *
  • marker - Given a string value X, return Object names greater in value than the specied * marker.
    • *
  • format - Specify either json or xml to return the respective serialized response.
    • *
*

- * At this time, a prex query parameter is not supported at the Account level. + * At this time, a prex query parameter is not supported at the Account level. * *

Large Container Lists

* The system will return a maximum of 10,000 Container names per request. To retrieve subsequent - * container names, another request must be made with a marker parameter. The marker indicates + * container names, another request must be made with a marker parameter. The marker indicates * where the last list left off and the system will return container names greater than this - * marker, up to 10,000 again. Note that the marker value should be URL encoded prior to + * marker, up to 10,000 again. Note that the marker value should be URL encoded prior to * sending the HTTP request. *

- * If 10,000 is larger than desired, a limit parameter may be given. + * If 10,000 is larger than desired, a limit parameter may be given. *

* If the number of container names returned equals the limit given (or 10,000 if no limit is * given), it can be assumed there are more container names to be listed. If the container name diff --git a/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/options/ListContainerOptions.java b/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/options/ListContainerOptions.java index 73248a0c7c..aff14eabb2 100644 --- a/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/options/ListContainerOptions.java +++ b/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/options/ListContainerOptions.java @@ -83,13 +83,13 @@ public class ListContainerOptions extends BaseHttpRequestOptions { * For a string value X, return the Object names nested in the pseudo path. *

* Users will be able to simulate a hierarchical structure in Cloud Files by following a few - * guidelines. Object names must contain the forward slash character / as a path element - * separator and also create directory marker Objects, then they will be able to traverse this - * nested structure with the new path query parameter. + * guidelines. Object names must contain the forward slash character / as a path element + * separator and also create directory marker Objects, then they will be able to traverse this + * nested structure with the new path query parameter. *

* To take advantage of this feature, the directory marker Objects must also be created to * represent the appropriate directories. The following additional Objects need to be created. A - * good convention would be to create these as zero or one byte les with a Content-Type of + * good convention would be to create these as zero or one byte files with a Content-Type of * application/directory */ public ListContainerOptions underPath(String path) { diff --git a/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/reference/CloudFilesConstants.java b/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/reference/CloudFilesConstants.java index af5338bbf6..8c720d3a2b 100755 --- a/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/reference/CloudFilesConstants.java +++ b/rackspace/src/main/java/org/jclouds/rackspace/cloudfiles/reference/CloudFilesConstants.java @@ -37,7 +37,7 @@ public interface CloudFilesConstants extends RackspaceConstants { */ String LIMIT = "limit"; /** - * Given a string value X, return Object names greater in value than the specied marker. + * Given a string value X, return Object names greater in value than the specified marker. */ String MARKER = "marker"; /** diff --git a/rackspace/src/main/java/org/jclouds/rackspace/cloudservers/domain/Image.java b/rackspace/src/main/java/org/jclouds/rackspace/cloudservers/domain/Image.java index 5b85d93899..6a16eaa79a 100644 --- a/rackspace/src/main/java/org/jclouds/rackspace/cloudservers/domain/Image.java +++ b/rackspace/src/main/java/org/jclouds/rackspace/cloudservers/domain/Image.java @@ -28,7 +28,7 @@ import org.joda.time.DateTime; /** * An image is a collection of files used to create or rebuild a server. Rackspace provides a number * of pre-built OS images by default. You may also create custom images from cloud servers you have - * launched. These custom images are useful for backup purposes or for producing gold server + * launched. These custom images are useful for backup purposes or for producing gold server * images if you plan to deploy a particular server configuration frequently. * * @author Adrian Cole diff --git a/vcloud/core/src/main/java/org/jclouds/vcloud/VCloudClient.java b/vcloud/core/src/main/java/org/jclouds/vcloud/VCloudClient.java index c6c800f2df..6f6a658d43 100644 --- a/vcloud/core/src/main/java/org/jclouds/vcloud/VCloudClient.java +++ b/vcloud/core/src/main/java/org/jclouds/vcloud/VCloudClient.java @@ -97,7 +97,7 @@ public interface VCloudClient { Future undeploy(@Endpoint URI vApp); /** - * This call powers on the vApp, as specified in the vApps ovf:Startup element. + * This call powers on the vApp, as specified in the vApp's ovf:Startup element. */ @POST @Consumes(TASK_XML) @@ -106,7 +106,7 @@ public interface VCloudClient { Future powerOn(@Endpoint URI vApp); /** - * This call powers off the vApp, as specified in the vApps ovf:Startup element. + * This call powers off the vApp, as specified in the vApp's ovf:Startup element. */ @POST @Consumes(TASK_XML)