Package org.apache.hadoop.registry.client.binding

Class RegistryUtils

java.lang.Object

org.apache.hadoop.registry.client.binding.RegistryUtils

@Public
@Evolving
public class RegistryUtils
extends java.lang.Object

Utility methods for working with a registry.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RegistryUtils.ServiceRecordMarshal	Static instance of service record marshalling

Constructor Summary

Constructors

Constructor	Description
RegistryUtils()

Method Summary

Modifier and Type	Method	Description
static java.lang.String	componentListPath(java.lang.String user, java.lang.String serviceClass, java.lang.String serviceName)	Create a path for listing components under a service
static java.lang.String	componentPath(java.lang.String user, java.lang.String serviceClass, java.lang.String serviceName, java.lang.String componentName)	Create the path to a service record for a component
static java.lang.String	convertUsername(java.lang.String username)	Convert the username to that which can be used for registry entries.
static java.lang.String	currentUser()	Get the current user path formatted for the registry
static java.util.Map<java.lang.String,ServiceRecord>	extractServiceRecords(RegistryOperations operations, java.lang.String parentpath)	Extract all service records under a list of stat operations...this non-atomic action skips entries that are too short or simply not matching.
static java.util.Map<java.lang.String,ServiceRecord>	extractServiceRecords(RegistryOperations operations, java.lang.String parentpath, java.util.Collection<RegistryPathStatus> stats)	Extract all service records under a list of stat operations...this skips entries that are too short or simply not matching
static java.util.Map<java.lang.String,ServiceRecord>	extractServiceRecords(RegistryOperations operations, java.lang.String parentpath, java.util.Map<java.lang.String,RegistryPathStatus> stats)	Extract all service records under a list of stat operations...this non-atomic action skips entries that are too short or simply not matching.
static java.lang.String	getCurrentUsernameUnencoded(java.lang.String env_hadoop_username)	Get the current username, using the value of the parameter env_hadoop_username if it is set on an insecure cluster.
static java.lang.String	homePathForCurrentUser()	Get the home path of the current user.
static java.lang.String	homePathForUser(java.lang.String username)	Buld the user path -switches to the system path if the user is "".
static java.util.Map<java.lang.String,ServiceRecord>	listServiceRecords(RegistryOperations registryOperations, java.lang.String path)	List service records directly under a path
static java.lang.String	registryUser(java.lang.String shortUserName)	Convert the given user name formatted for the registry.
static java.lang.String	serviceclassPath(java.lang.String user, java.lang.String serviceClass)	Create a service classpath
static java.lang.String	servicePath(java.lang.String user, java.lang.String serviceClass, java.lang.String serviceName)	Create a path to a service under a user and service class
static java.util.Map<java.lang.String,RegistryPathStatus>	statChildren(RegistryOperations registryOperations, java.lang.String path)	List children of a directory and retrieve their RegistryPathStatus values.

Methods inherited from class java.lang.Object

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

Constructor Detail

RegistryUtils

public RegistryUtils()

Method Detail

homePathForUser

public static java.lang.String homePathForUser(java.lang.String username)

Buld the user path -switches to the system path if the user is "". It also cross-converts the username to ascii via punycode

Parameters:

username - username or ""

Returns:

the path to the user

convertUsername

public static java.lang.String convertUsername(java.lang.String username)

Convert the username to that which can be used for registry entries. Lower cases it, Strip the kerberos realm off a username if needed, and any "/" hostname entries

Parameters:

username - user

Returns:

the converted username

serviceclassPath

public static java.lang.String serviceclassPath(java.lang.String user,
                                                java.lang.String serviceClass)

Create a service classpath

Parameters:

user - username or ""

serviceClass - service name

Returns:

a full path

servicePath

public static java.lang.String servicePath(java.lang.String user,
                                           java.lang.String serviceClass,
                                           java.lang.String serviceName)

Create a path to a service under a user and service class

Parameters:

user - username or ""

serviceClass - service name

serviceName - service name unique for that user and service class

Returns:

a full path

componentListPath

public static java.lang.String componentListPath(java.lang.String user,
                                                 java.lang.String serviceClass,
                                                 java.lang.String serviceName)

Create a path for listing components under a service

Parameters:

user - username or ""

serviceClass - service name

serviceName - service name unique for that user and service class

Returns:

a full path

componentPath

public static java.lang.String componentPath(java.lang.String user,
                                             java.lang.String serviceClass,
                                             java.lang.String serviceName,
                                             java.lang.String componentName)

Create the path to a service record for a component

Parameters:

user - username or ""

serviceClass - service name

serviceName - service name unique for that user and service class

componentName - unique name/ID of the component

Returns:

a full path

listServiceRecords

public static java.util.Map<java.lang.String,ServiceRecord> listServiceRecords(RegistryOperations registryOperations,
                                                                                     java.lang.String path)
                                                                              throws java.io.IOException

List service records directly under a path

Parameters:

registryOperations - registry operations instance

path - path to list

Returns:

a mapping of the service records that were resolved, indexed by their full path

Throws:

java.io.IOException

statChildren

public static java.util.Map<java.lang.String,RegistryPathStatus> statChildren(RegistryOperations registryOperations,
                                                                                    java.lang.String path)
                                                                             throws org.apache.hadoop.fs.PathNotFoundException,
                                                                                    InvalidPathnameException,
                                                                                    java.io.IOException

List children of a directory and retrieve their RegistryPathStatus values.

This is not an atomic operation; A child may be deleted during the iteration through the child entries. If this happens, the PathNotFoundException is caught and that child entry ommitted.

Parameters:

path - path

Returns:

a possibly empty map of child entries listed by their short name.

Throws:

org.apache.hadoop.fs.PathNotFoundException - path is not in the registry.

InvalidPathnameException - the path is invalid.

java.io.IOException - Any other IO Exception

homePathForCurrentUser

public static java.lang.String homePathForCurrentUser()

Get the home path of the current user.

In an insecure cluster, the environment variable HADOOP_USER_NAME is queried first.

This means that in a YARN container where the creator set this environment variable to propagate their identity, the defined user name is used in preference to the actual user.

In a secure cluster, the kerberos identity of the current user is used.

Returns:

a path for the current user's home dir.

Throws:

java.lang.RuntimeException - if the current user identity cannot be determined from the OS/kerberos.

getCurrentUsernameUnencoded

@VisibleForTesting
public static java.lang.String getCurrentUsernameUnencoded(java.lang.String env_hadoop_username)

Get the current username, using the value of the parameter env_hadoop_username if it is set on an insecure cluster. This ensures that the username propagates correctly across processes started by YARN.

This method is primarly made visible for testing.

Parameters:

env_hadoop_username - the environment variable

Returns:

the selected username

Throws:

java.lang.RuntimeException - if there is a problem getting the short user name of the current user.

currentUser

public static java.lang.String currentUser()

Get the current user path formatted for the registry

In an insecure cluster, the environment variable HADOOP_USER_NAME is queried first.

This means that in a YARN container where the creator set this environment variable to propagate their identity, the defined user name is used in preference to the actual user.

In a secure cluster, the kerberos identity of the current user is used.

Returns:

the encoded shortname of the current user

Throws:

java.lang.RuntimeException - if the current user identity cannot be determined from the OS/kerberos.

registryUser

public static java.lang.String registryUser(java.lang.String shortUserName)

Convert the given user name formatted for the registry.

Parameters:

shortUserName -

Returns:

converted user name

extractServiceRecords

public static java.util.Map<java.lang.String,ServiceRecord> extractServiceRecords(RegistryOperations operations,
                                                                                        java.lang.String parentpath,
                                                                                        java.util.Collection<RegistryPathStatus> stats)
                                                                                 throws java.io.IOException

Extract all service records under a list of stat operations...this skips entries that are too short or simply not matching

Parameters:

operations - operation support for fetches

parentpath - path of the parent of all the entries

stats - Collection of stat results

Returns:

a possibly empty map of fullpath:record.

Throws:

java.io.IOException - for any IO Operation that wasn't ignored.

extractServiceRecords

public static java.util.Map<java.lang.String,ServiceRecord> extractServiceRecords(RegistryOperations operations,
                                                                                        java.lang.String parentpath,
                                                                                        java.util.Map<java.lang.String,RegistryPathStatus> stats)
                                                                                 throws java.io.IOException

Extract all service records under a list of stat operations...this non-atomic action skips entries that are too short or simply not matching.

Parameters:

operations - operation support for fetches

parentpath - path of the parent of all the entries

Returns:

a possibly empty map of fullpath:record.

Throws:

java.io.IOException - for any IO Operation that wasn't ignored.

extractServiceRecords

public static java.util.Map<java.lang.String,ServiceRecord> extractServiceRecords(RegistryOperations operations,
                                                                                        java.lang.String parentpath)
                                                                                 throws java.io.IOException

Extract all service records under a list of stat operations...this non-atomic action skips entries that are too short or simply not matching.

Parameters:

operations - operation support for fetches

parentpath - path of the parent of all the entries

Returns:

a possibly empty map of fullpath:record.

Throws:

java.io.IOException - for any IO Operation that wasn't ignored.