4.3.1.8 ClusterJHelper

ClusterJHelper 提供辅助方法来连接 API 和实现。

4.3.1.8.1 概要
 public  class  ClusterJHelper  {
// 公共构造函数// 公共静态方法}  public ClusterJHelper();
  public static boolean getBooleanProperty(String propertyName,
                                           String def);

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

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

  public static 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(字符串,字符串)
public static boolean getBooleanProperty(String propertyName,
                                         String def);

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

表 4.5 getBooleanProperty(String, String)

范围 描述
财产名称 房产名称
定义 如果未设置该属性,则为默认值
返回 系统属性,如果它是通过 -D 或系统环境设置的

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

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

表 4.6 getServiceInstance(Class<T>)

范围 描述
控制系统 工厂类
返回 服务实例

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

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

表 4.7 getServiceInstance(Class<T>, ClassLoader)

范围 描述
控制系统 工厂类
装载机 工厂实现的类加载器
返回 服务实例

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

找到服务的服务实现。如果实现名称不为空,则使用它而不是查找。如果实现类不可加载或没有实现接口,则抛出异常。使用 ClusterJHelper 类加载器来查找服务。

表 4.8 getServiceInstance(Class<T>, String)

范围 描述
控制系统

实现类名

返回 服务的实现实例

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

找到服务的服务实现。如果实现名称不为空,则使用它而不是查找。如果实现类不可加载或没有实现接口,则抛出异常。

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

范围 描述
控制系统

实现类名 要加载的实现类的名称
装载机 用于查找服务的 ClassLoader
返回 服务的实现实例

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)

范围 描述
控制系统 工厂类
装载机 工厂实现的类加载器
错误信息 用于保存错误消息的缓冲区
返回 服务实例

4.3.1.8.8 getSessionFactory(地图)
public static SessionFactory getSessionFactory(Map props);

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

表 4.11 getSessionFactory(Map)

范围 描述
道具 会话工厂的属性
返回 会话工厂

例外情况

ClusterFatalUserException

如果无法连接到集群

4.3.1.8.9 getSessionFactory(地图,类加载器)
public static SessionFactory getSessionFactory(Map props,
                                               ClassLoader loader);

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

表 4.12 getSessionFactory(Map, ClassLoader)

范围 描述
道具 工厂的属性
装载机 工厂实现的类加载器
返回 会话工厂

例外情况

ClusterFatalUserException

如果无法连接到集群

4.3.1.8.10 getStringProperty(字符串,字符串)
public static String getStringProperty(String propertyName,
                                       String def);

从环境或系统属性中获取命名的 String 属性。

表 4.13 getStringProperty(String, String)

范围 描述
财产名称 房产名称
定义 如果未设置该属性,则为默认值
返回 系统属性,如果它是通过 -D 或系统环境设置的

4.3.1.8.11 newDbug()
public static Dbug newDbug();

返回一个新的 Dbug 实例。

表 4.14 newDbug()

范围 描述
返回 一个新的 Dbug 实例