ai.rapids.cudf

类 NativeDepsLoader

java.lang.Object

ai.rapids.cudf.NativeDepsLoader

public class NativeDepsLoader
extends Object

此类将加载原生依赖项。

构造器摘要

构造器

构造器和描述
NativeDepsLoader()

方法摘要

修饰符和类型	方法和描述
static boolean	libraryLoaded()
static File	loadNativeDep(String depName, boolean preserveDep) 允许其他库重用相同的原生依赖加载逻辑。
static void	loadNativeDeps() 加载 libcudf 所需的原生库，如果尚未加载。
static void	loadNativeDeps(String[] loadOrder) 允许其他库重用相同的原生依赖加载逻辑。
static void	loadNativeDeps(String[] loadOrder, boolean preserveDeps) 允许其他库重用相同的原生依赖加载逻辑。

从类 java.lang.Object 继承的方法

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

构造器详细信息

NativeDepsLoader

public NativeDepsLoader()

方法详细信息

loadNativeDeps

public static void loadNativeDeps()

加载 libcudf 所需的原生库，如果尚未加载。

loadNativeDeps

public static void loadNativeDeps(String[] loadOrder)
                           throws IOException

允许其他库重用相同的原生依赖加载逻辑。库将在类路径中 `${os.arch}/${os.name}/` 下使用此类的类加载器进行搜索。
因为这只是加载库，并且库本身的加载需要是单例操作，所以建议使用此功能的任何库提供类似的包装函数

     private static boolean loaded = false;
     static synchronized void loadNativeDeps() {
         if (!loaded) {
             try {
                 // If you also depend on the cudf liobrary being loaded, be sure it is loaded
                 // first
                 ai.rapids.cudf.NativeDepsLoader.loadNativeDeps();
                 ai.rapids.cudf.NativeDepsLoader.loadNativeDeps(new String[]{...});
                 loaded = true;
             } catch (Throwable t) {
                 log.error("Could not load ...", t);
             }
         }
     }
 

此函数应从使用 JNI 的任何类的静态初始化块中调用。例如

     public class UsesJNI {
         static {
             MyNativeDepsLoader.loadNativeDeps();
         }
     }
 

参数

loadOrder - 库的基础名称。例如，libfoo.so 将作为 "foo" 传入。库将按照提供的顺序加载。

抛出

IOException - 尝试加载库时发生的任何错误。

loadNativeDeps

public static void loadNativeDeps(String[] loadOrder,
                                  boolean preserveDeps)
                           throws IOException

允许其他库重用相同的原生依赖加载逻辑。库将在类路径中 `${os.arch}/${os.name}/` 下使用此类的类加载器进行搜索。
因为这只是加载库，并且库本身的加载需要是单例操作，所以建议使用此功能的任何库提供类似的包装函数

     private static boolean loaded = false;
     static synchronized void loadNativeDeps() {
         if (!loaded) {
             try {
                 // If you also depend on the cudf liobrary being loaded, be sure it is loaded
                 // first
                 ai.rapids.cudf.NativeDepsLoader.loadNativeDeps();
                 ai.rapids.cudf.NativeDepsLoader.loadNativeDeps(new String[]{...});
                 loaded = true;
             } catch (Throwable t) {
                 log.error("Could not load ...", t);
             }
         }
     }
 

此函数应从使用 JNI 的任何类的静态初始化块中调用。例如

     public class UsesJNI {
         static {
             MyNativeDepsLoader.loadNativeDeps();
         }
     }
 

参数

loadOrder - 库的基础名称。例如，libfoo.so 将作为 "foo" 传入。库将按照提供的顺序加载。

preserveDeps - 如果为 false，依赖项将在加载后立即删除，而不是在退出时删除。

抛出

IOException - 尝试加载库时发生的任何错误。

loadNativeDep

public static File loadNativeDep(String depName,
                                 boolean preserveDep)
                          throws IOException

允许其他库重用相同的原生依赖加载逻辑。库将在类路径中 `${os.arch}/${os.name}/` 下使用此类的类加载器进行搜索。

参数

depName - 库的基础名称。例如，libfoo.so 将作为 "foo" 传入。库将按照提供的顺序加载。

preserveDep - 如果为 false，依赖项将在加载后立即删除，而不是在退出时删除。

返回

依赖项加载的路径

抛出

IOException - 尝试加载库时发生的任何错误。

libraryLoaded

public static boolean libraryLoaded()