MySQL :: MySQL NDB Cluster API 开发人员指南 :: 4.3.1.8 ClusterJHelper

MySQL NDB Cluster API 开发人员指南 / ... / ClusterJHelper

4.3.1.8 ClusterJHelper

4.3.1.8.1 概要
4.3.1.8.2 getBooleanProperty(String, String)
4.3.1.8.3 getServiceInstance(Class<T>)
4.3.1.8.4 getServiceInstance(Class<T>, ClassLoader)
4.3.1.8.5 getServiceInstance(Class<T>, String)
4.3.1.8.6 getServiceInstance(Class<T>, String, ClassLoader)
4.3.1.8.7 getServiceInstances(Class<T>, ClassLoader, StringBuffer)
4.3.1.8.8 getSessionFactory(Map)
4.3.1.8.9 getSessionFactory(Map, ClassLoader)
4.3.1.8.10 getStringProperty(String, String)
4.3.1.8.11 newDbug()

ClusterJHelper 提供了在 API 和实现之间建立桥梁的辅助方法。

4.3.1.8.1 概要

 public class ClusterJHelper {
// Public Constructors  public ClusterJHelper();
// Public Static Methods  public static boolean getBooleanProperty(String propertyName,
                                           String def);
  public static T getServiceInstance(Class<T> cls);
  public static T getServiceInstance(Class<T> cls,
                                     ClassLoader loader);
  public static T getServiceInstance(Class<T> cls,
                                     String implementationClassName);
  public static T getServiceInstance(Class<T> cls,
                                     String implementationClassName,
                                     ClassLoader loader);
  public static List<T> getServiceInstances(Class<T> cls,
                                            ClassLoader loader,
                                            StringBuffer errorMessages);
  public static SessionFactory getSessionFactory(Map props);
  public static SessionFactory getSessionFactory(Map props,
                                                 ClassLoader loader);
  public static String getStringProperty(String propertyName,
                                         String def);
  public static Dbug newDbug();
}

从 java.lang.Object 继承的方法: equals , getClass , hashCode , notify , notifyAll , toString , wait

4.3.1.8.2 getBooleanProperty(String, String)

public static boolean getBooleanProperty(String propertyName,
                                         String def);

从环境或系统属性中获取命名的布尔属性。如果属性不是“true”，则返回 false。

表 4.5 getBooleanProperty(String, String)

参数	描述
propertyName	属性的名称
def	如果未设置属性，则使用默认值
return	如果通过 -D 或系统环境设置了系统属性，则返回该属性

4.3.1.8.3 getServiceInstance(Class<T>)

public static T getServiceInstance(Class<T> cls);

通过上下文类加载器的服务查找来定位服务实现。

表 4.6 getServiceInstance(Class<T>)

参数	描述
cls	工厂的类
return	服务实例

4.3.1.8.4 getServiceInstance(Class<T>, ClassLoader)

public static T getServiceInstance(Class<T> cls,
                                   ClassLoader loader);

通过特定类加载器的服务查找来定位服务的实现。返回找到的第一个服务实例。

表 4.7 getServiceInstance(Class<T>, ClassLoader)

参数	描述
cls	工厂的类
loader	工厂实现的类加载器
return	服务实例

4.3.1.8.5 getServiceInstance(Class<T>, String)

public static T getServiceInstance(Class<T> cls,
                                   String implementationClassName);

定位服务的实现。如果实现名称不为空，则使用它而不是查找。如果无法加载实现类或未实现接口，则抛出异常。使用 ClusterJHelper 类加载器查找服务。

表 4.8 getServiceInstance(Class<T>, String)

参数	描述
cls
implementationClassName
return	服务的实现实例

4.3.1.8.6 getServiceInstance(Class<T>, String, ClassLoader)

public static T getServiceInstance(Class<T> cls,
                                   String implementationClassName,
                                   ClassLoader loader);

定位服务的实现。如果实现名称不为空，则使用它而不是查找。如果无法加载实现类或未实现接口，则抛出异常。

表 4.9 getServiceInstance(Class<T>, String, ClassLoader)

参数	描述
cls
implementationClassName	要加载的实现类的名称
loader	用于查找服务的 ClassLoader
return	服务的实现实例

4.3.1.8.7 getServiceInstances(Class<T>, ClassLoader, StringBuffer)

public static List<T> getServiceInstances(Class<T> cls,
                                          ClassLoader loader,
                                          StringBuffer errorMessages);

通过特定类加载器的服务查找来定位所有服务实现。服务文件中的实现将被实例化并返回。失败的实例化将记录在 errorMessages 缓冲区中。

表 4.10 getServiceInstances(Class<T>, ClassLoader, StringBuffer)

参数	描述
cls	工厂的类
loader	工厂实现的类加载器
errorMessages	用于保存错误消息的缓冲区
return	服务实例

4.3.1.8.8 getSessionFactory(Map)

public static SessionFactory getSessionFactory(Map props);

通过服务查找来定位 SessionFactory 实现。使用的类加载器是线程的上下文类加载器。

表 4.11 getSessionFactory(Map)

参数	描述
props	会话工厂的属性
return	会话工厂

异常

ClusterFatalUserException: 如果无法建立与集群的连接

4.3.1.8.9 getSessionFactory(Map, ClassLoader)

public static SessionFactory getSessionFactory(Map props,
                                               ClassLoader loader);

通过特定类加载器的服务查找来定位 SessionFactory 实现。属性是一个 Map，它可能包含特定于实现的属性以及标准属性。

表 4.12 getSessionFactory(Map, ClassLoader)

参数	描述
props	工厂的属性
loader	工厂实现的类加载器
return	会话工厂

异常

ClusterFatalUserException: 如果无法建立与集群的连接

4.3.1.8.10 getStringProperty(String, String)

public static String getStringProperty(String propertyName,
                                       String def);

从环境或系统属性中获取命名的字符串属性。

表 4.13 getStringProperty(String, String)

参数	描述
propertyName	属性的名称
def	如果未设置属性，则使用默认值
return	如果通过 -D 或系统环境设置了系统属性，则返回该属性

4.3.1.8.11 newDbug()

public static Dbug newDbug();

返回一个新的 Dbug 实例。

表 4.14 newDbug()

参数	描述
return	一个新的 Dbug 实例