org.infinispan.query.remote.client.ProtobufMetadataManagerMBean Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of infinispan-embedded

Infinispan Embedded All-in-One module

There is a newer version: 9.1.7.Final

package org.infinispan.query.remote.client;

/**
 * MBean interface for ProtobufMetadataManager,suitable for building invocation proxies with one of the {@link
 * javax.management.JMX#newMBeanProxy} methods.
 *
 * @author [email protected]
 * @author gustavonalle
 * @since 7.1
 */
public interface ProtobufMetadataManagerMBean extends ProtobufMetadataManagerConstants {

   /**
    * Register a *.proto schema file.
    *
    * @param fileName the full name of the file (name can contain '/'); must end with ".proto" suffix
    * @param contents the file contents
    * @throws Exception if the file has invalid syntax
    */
   void registerProtofile(String fileName, String contents) throws Exception;

   /**
    * Registers multiple *.proto schema files.
    *
    * @param fileNames the full names of the files (name can contain '/'); names must end with ".proto" suffix
    * @param contents  the contents of each file; this array must have the same length as {@code fileNames}
    * @throws Exception Exception if any of files has invalid syntax
    */
   void registerProtofiles(String[] fileNames, String[] contents) throws Exception;

   /**
    * Unregister a *.proto schema file.
    *
    * @param fileName the full name of the file (name can contain '/'); must end with ".proto" suffix
    * @throws Exception in case of failure
    */
   void unregisterProtofile(String fileName) throws Exception;

   /**
    * Unregisters multiple *.proto schema files.
    *
    * @param fileNames the full names of the files (name can contain '/'); names must end with ".proto" suffix
    * @throws Exception in case of failure
    */
   void unregisterProtofiles(String[] fileNames) throws Exception;

   /**
    * Get the full names of all registered schema files.
    *
    * @return the array of all registered schema file names, never null
    */
   String[] getProtofileNames();

   /**
    * Gets the contents of a registered *.proto schema file.
    *
    * @param fileName the name of the file; must end with ".proto" suffix
    * @return the file contents or {@code null} if the file does not exist
    */
   String getProtofile(String fileName);

   /**
    * Get the full names of all registered schema files.
    *
    * @return the array of all registered schema file names, never null
    */
   String[] getFilesWithErrors();

   /**
    * Gets the error messages (caused by parsing, linking, etc) associated to a *.proto schema file.
    *
    * @param fileName the name of the file; must end with ".proto" suffix
    * @return the error text or {@code null} if there are no errors
    */
   String getFileErrors(String fileName);
}