Package ai.pipestream.common.util.descriptor

Class GoogleDescriptorLoader

java.lang.Object

ai.pipestream.common.util.descriptor.GoogleDescriptorLoader

All Implemented Interfaces:

DescriptorLoader

public class GoogleDescriptorLoader
extends Object
implements DescriptorLoader

Loads Protocol Buffer descriptors from Google descriptor set files (.dsc). These files are typically generated by protoc with --descriptor_set_out flag and packaged in JAR files under META-INF/grpc/.

Example usage:

 GoogleDescriptorLoader loader = new GoogleDescriptorLoader("META-INF/grpc/services.dsc");
 List<FileDescriptor> descriptors = loader.loadDescriptors();
 

Nested Class Summary

Nested classes/interfaces inherited from interface ai.pipestream.common.util.descriptor.DescriptorLoader

DescriptorLoader.DescriptorLoadException

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_DESCRIPTOR_PATH	Default descriptor path used by grpc-google-descriptor module.

Constructor Summary

Constructors

Constructor	Description
GoogleDescriptorLoader()	Creates a loader with the default descriptor path.
GoogleDescriptorLoader(String descriptorPath)	Creates a loader with a custom descriptor path.
GoogleDescriptorLoader(String descriptorPath, ClassLoader classLoader)	Creates a loader with a custom descriptor path and class loader.

Method Summary

Modifier and Type	Method	Description
String	getDescriptorPath()	Gets the descriptor path being used.
String	getLoaderType()	Gets a human-readable name for this loader type.
boolean	isAvailable()	Checks if this loader is available and can load descriptors.
com.google.protobuf.Descriptors.FileDescriptor	loadDescriptor(String fileName)	Loads a specific file descriptor by name.
List<com.google.protobuf.Descriptors.FileDescriptor>	loadDescriptors()	Loads all available file descriptors from this loader's source.
static GoogleDescriptorLoader	searchPaths(String... paths)	Creates a loader that searches for descriptor files in multiple locations.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_DESCRIPTOR_PATH

public static final String DEFAULT_DESCRIPTOR_PATH

Default descriptor path used by grpc-google-descriptor module.

See Also:

• Constant Field Values

Constructor Details

GoogleDescriptorLoader

public GoogleDescriptorLoader()

Creates a loader with the default descriptor path.

GoogleDescriptorLoader

public GoogleDescriptorLoader(String descriptorPath)

Creates a loader with a custom descriptor path.

Parameters:

descriptorPath - The classpath resource path to the .dsc file

GoogleDescriptorLoader

public GoogleDescriptorLoader(String descriptorPath,
 ClassLoader classLoader)

Creates a loader with a custom descriptor path and class loader.

Parameters:

descriptorPath - The classpath resource path to the .dsc file

classLoader - The class loader to use for loading resources

Method Details

loadDescriptors

public List<com.google.protobuf.Descriptors.FileDescriptor> loadDescriptors()
                                                                     throws DescriptorLoader.DescriptorLoadException

Description copied from interface: DescriptorLoader

Loads all available file descriptors from this loader's source.

Specified by:

loadDescriptors in interface DescriptorLoader

Returns:

A list of FileDescriptors

Throws:

DescriptorLoader.DescriptorLoadException - if loading fails

loadDescriptor

public com.google.protobuf.Descriptors.FileDescriptor loadDescriptor(String fileName)
                                                              throws DescriptorLoader.DescriptorLoadException

Description copied from interface: DescriptorLoader

Loads a specific file descriptor by name.

Specified by:

loadDescriptor in interface DescriptorLoader

Parameters:

fileName - The proto file name (e.g., "my_types.proto")

Returns:

The FileDescriptor, or null if not found

Throws:

DescriptorLoader.DescriptorLoadException - if loading fails

isAvailable

public boolean isAvailable()

Description copied from interface: DescriptorLoader

Checks if this loader is available and can load descriptors. For example, a GoogleDescriptorLoader would return false if the .dsc file is not on classpath.

Specified by:

isAvailable in interface DescriptorLoader

Returns:

true if the loader can load descriptors

getLoaderType

public String getLoaderType()

Description copied from interface: DescriptorLoader

Gets a human-readable name for this loader type.

Specified by:

getLoaderType in interface DescriptorLoader

Returns:

The loader type name

getDescriptorPath

public String getDescriptorPath()

Gets the descriptor path being used.

Returns:

The descriptor path

searchPaths

public static GoogleDescriptorLoader searchPaths(String... paths)

Creates a loader that searches for descriptor files in multiple locations.

Parameters:

paths - The paths to search

Returns:

A loader that tries each path until one succeeds