com.google.cloud.hadoop.gcsio

Class GoogleCloudStorageStrings

java.lang.Object

com.google.cloud.hadoop.gcsio.GoogleCloudStorageStrings

public class GoogleCloudStorageStrings
extends java.lang.Object

Contains helper methods for standardizing String-matching algorithms specific to GCS.

Constructor Summary

Constructors

Constructor and Description
GoogleCloudStorageStrings()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	matchListPrefix(java.lang.String objectNamePrefix, java.lang.String delimiter, java.lang.String objectName) Helper that mimics the GCS API behavior for taking an existing objectName and checking if it matches a user-supplied prefix with an optional directory "delimiter".

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GoogleCloudStorageStrings

public GoogleCloudStorageStrings()

Method Detail

matchListPrefix

public static java.lang.String matchListPrefix(java.lang.String objectNamePrefix,
                                               java.lang.String delimiter,
                                               java.lang.String objectName)

Helper that mimics the GCS API behavior for taking an existing objectName and checking if it matches a user-supplied prefix with an optional directory "delimiter". If it matches, either the full objectName will be returned unmodified, or the return value will be a String that is a prefix of the objectName inclusive of the matching prefix but truncating any suffix past the first appearance of the delimiter after the full prefix. The returned prefix includes the delimiter String at which the objectName was truncated.

Parameters:

objectNamePrefix - The prefix that objectName must match to be returned in any form. May be null; then an objectName will always be returned, just possibly truncated.

delimiter - The delimiter (usually a directory separator, e.g. '/') at which to truncate the returned objectName after including the matched prefix. May be null for no truncation.

objectName - The name to attempt to match against the prefix and delimiter.

Returns:

A substring of objectName or the full unaltered objectName after applying GCS matching logic, or null if the supply objectName does not match the provided prefix.