@InterfaceAudience.Public @InterfaceStability.Evolving public class RegistryOperationsService extends org.apache.hadoop.registry.client.impl.zk.CuratorService implements RegistryOperations
This service implements the RegistryOperations
API by mapping the commands to zookeeper operations, and translating
results and exceptions back into those specified by the API.
Factory methods should hide the detail that this has been implemented via
the CuratorService by returning it cast to that
RegistryOperations interface, rather than this implementation class.
STOP_ONLY_STARTED_SERVICESDEFAULT_DNS_ENABLED, DEFAULT_DNS_PORT, DEFAULT_DNS_SPLIT_REVERSE_ZONE, DEFAULT_DNSSEC_PRIVATE_KEY_FILE, DEFAULT_REGISTRY_CLIENT_JAAS_CONTEXT, DEFAULT_REGISTRY_SECURE, DEFAULT_REGISTRY_SYSTEM_ACCOUNTS, DEFAULT_REGISTRY_USER_ACCOUNTS, DEFAULT_REGISTRY_ZK_QUORUM, DEFAULT_ZK_CONNECTION_TIMEOUT, DEFAULT_ZK_REGISTRY_ROOT, DEFAULT_ZK_RETRY_CEILING, DEFAULT_ZK_RETRY_INTERVAL, DEFAULT_ZK_RETRY_TIMES, DEFAULT_ZK_SESSION_TIMEOUT, DNS_PREFIX, KEY_DNS_BIND_ADDRESS, KEY_DNS_DOMAIN, KEY_DNS_ENABLED, KEY_DNS_PORT, KEY_DNS_SPLIT_REVERSE_ZONE, KEY_DNS_SPLIT_REVERSE_ZONE_RANGE, KEY_DNS_TTL, KEY_DNS_ZONE_IP_MAX, KEY_DNS_ZONE_IP_MIN, KEY_DNS_ZONE_MASK, KEY_DNS_ZONE_SUBNET, KEY_DNS_ZONES_DIR, KEY_DNSSEC_ENABLED, KEY_DNSSEC_PRIVATE_KEY_FILE, KEY_DNSSEC_PUBLIC_KEY, KEY_REGISTRY_CLIENT_AUTH, KEY_REGISTRY_CLIENT_AUTHENTICATION_ID, KEY_REGISTRY_CLIENT_AUTHENTICATION_PASSWORD, KEY_REGISTRY_CLIENT_JAAS_CONTEXT, KEY_REGISTRY_KERBEROS_REALM, KEY_REGISTRY_SECURE, KEY_REGISTRY_SYSTEM_ACCOUNTS, KEY_REGISTRY_USER_ACCOUNTS, KEY_REGISTRY_ZK_CONNECTION_TIMEOUT, KEY_REGISTRY_ZK_QUORUM, KEY_REGISTRY_ZK_RETRY_CEILING, KEY_REGISTRY_ZK_RETRY_INTERVAL, KEY_REGISTRY_ZK_RETRY_TIMES, KEY_REGISTRY_ZK_ROOT, KEY_REGISTRY_ZK_SESSION_TIMEOUT, MAX_FQDN_LABEL_LENGTH, PATH_SYSTEM_SERVICES, PATH_USER_SERVICES, PATH_USERS, REGISTRY_CLIENT_AUTH_ANONYMOUS, REGISTRY_CLIENT_AUTH_DIGEST, REGISTRY_CLIENT_AUTH_KERBEROS, REGISTRY_CLIENT_AUTH_SIMPLE, REGISTRY_PREFIX, SUBPATH_COMPONENTS, ZK_PREFIX| Constructor and Description |
|---|
RegistryOperationsService() |
RegistryOperationsService(String name) |
RegistryOperationsService(String name,
RegistryBindingSource bindingSource) |
| Modifier and Type | Method and Description |
|---|---|
void |
bind(String path,
ServiceRecord record,
int flags)
Bind a path in the registry to a service record
|
void |
delete(String path,
boolean recursive)
Delete a path.
|
boolean |
exists(String path)
Probe for a path existing.
|
List<org.apache.zookeeper.data.ACL> |
getClientAcls()
Get the aggregate set of ACLs the client should use
to create directories
|
List<String> |
list(String path)
List all entries under a registry path, returning the relative names
of the entries.
|
boolean |
mknode(String path,
boolean createParents)
Create a path.
|
ServiceRecord |
resolve(String path)
Resolve the record at a path
|
RegistryPathStatus |
stat(String path)
Get the status of a path
|
protected void |
validatePath(String path)
Validate a path
|
addWriteAccessor, bindingDiagnosticDetails, buildConnectionString, buildSecurityDiagnostics, clearWriteAccessors, createEnsembleProvider, createFullPath, dumpPath, dumpRegistryRobustly, getBindingSource, getRegistrySecurity, instantiateCacheForRegistry, isSecure, maybeCreate, operationFailure, operationFailure, registerPathListener, serviceInit, serviceStart, serviceStop, setKerberosPrincipalAndKeytab, startCache, supplyBindingInformation, toString, zkCreate, zkDelete, zkGetACLS, zkList, zkMkParentPath, zkMkPath, zkPathExists, zkPathMustExist, zkRead, zkSet, zkStat, zkUpdateaddIfService, addService, getServices, removeServiceclose, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, setConfig, start, stop, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStopclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitaddWriteAccessor, clearWriteAccessorsclose, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, registerServiceListener, start, stop, unregisterServiceListener, waitForServiceToStoppublic RegistryOperationsService(String name)
public RegistryOperationsService()
public RegistryOperationsService(String name, RegistryBindingSource bindingSource)
public List<org.apache.zookeeper.data.ACL> getClientAcls()
protected void validatePath(String path) throws InvalidPathnameException
path - path to validateInvalidPathnameException - if a path is considered invalidpublic boolean mknode(String path, boolean createParents) throws IOException
RegistryOperationsmknode in interface RegistryOperationspath - path to createcreateParents - also create the parents.org.apache.hadoop.fs.PathNotFoundException - parent path is not in the registry.InvalidPathnameException - path name is invalid.IOException - Any other IO Exception.public void bind(String path, ServiceRecord record, int flags) throws IOException
RegistryOperationsbind in interface RegistryOperationspath - path to service recordrecord - service record service record to create/updateflags - bind flagsorg.apache.hadoop.fs.PathNotFoundException - the parent path does not existFileAlreadyExistsException - path exists but create flags
do not include "overwrite"InvalidPathnameException - path name is invalid.IOException - Any other IO Exception.public ServiceRecord resolve(String path) throws IOException
RegistryOperationsresolve in interface RegistryOperationspath - path to an entry containing a ServiceRecordorg.apache.hadoop.fs.PathNotFoundException - path is not in the registry.NoRecordException - if there is not a service recordInvalidRecordException - if there was a service record but it could
not be parsed.IOException - Any other IO Exceptionpublic boolean exists(String path) throws IOException
RegistryOperationsRegistryOperations.stat(String) with
any failure downgraded to aexists in interface RegistryOperationspath - path to queryIOExceptionpublic RegistryPathStatus stat(String path) throws IOException
RegistryOperationsstat in interface RegistryOperationspath - path to queryorg.apache.hadoop.fs.PathNotFoundException - path is not in the registry.InvalidPathnameException - the path is invalid.IOException - Any other IO Exceptionpublic List<String> list(String path) throws IOException
RegistryOperationslist in interface RegistryOperationspath - path to queryorg.apache.hadoop.fs.PathNotFoundExceptionInvalidPathnameExceptionIOExceptionpublic void delete(String path, boolean recursive) throws IOException
RegistryOperationsdelete in interface RegistryOperationspath - path delete recursivelyrecursive - recursive flagorg.apache.hadoop.fs.PathNotFoundException - path is not in the registry.InvalidPathnameException - the path is invalid.org.apache.hadoop.fs.PathIsNotEmptyDirectoryException - path has child entries, but
recursive is false.IOException - Any other IO ExceptionCopyright © 2023 Apache Software Foundation. All rights reserved.