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);

尋找服務的服務實作。如果實作名稱不是 null，則改用它，而不是進行查詢。如果實作類別無法載入或未實作介面，則擲回例外狀況。使用 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);

尋找服務的服務實作。如果實作名稱不是 null，則改用它，而不是進行查詢。如果實作類別無法載入或未實作介面，則擲回例外狀況。

表格 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 實例