com.mathworks.toolbox.javabuilder.MWJavaObjectRef 类

命名空间: com.mathworks.toolbox.javabuilder

Java 类来创建一个引用 Java 对象的 MATLAB 数组

描述

声明

public class MWJavaObjectRef extends MWArray

MWJavaObjectRef 是 MWArray 的一个特殊子类，可用于创建引用 Java 对象的 MATLAB 数组

实现的接口：MWComponentOption、java.io.Serializable、java.lang.Cloneable、java.lang.Comparable

创建对象

构造函数

MWJavaObjectRef(java.lang.Object o)

实例化一个新的组件对象。

属性

全部展开

公共属性

`EMPTY_ARRAY` — 表示一个空数组
`public static final MWArray`

一种方便、高效且一致的方式来表示空数组，如下所示：

public static final MWArray EMPTY_ARRAY

方法

全部展开

公共方法

`applyVisitor`	`public abstract <T> T applyVisitor(AbstractMWArrayVisitor<T> v)` 此方法是抽象的，返回由类型参数<T>指定的类型。它以 `AbstractMWArrayVisitor<T>` 的一个实例作为参量。此方法的目的是将访问者模式应用于 MWArray 对象。通过使用适当的访问者调用此方法，您可以以类型安全的方式遍历 MWArray 的元素并执行操作。参数： v `AbstractMWArrayVisitor<T>` 的一个实例，代表要应用于 MWArray 对象的访问者。返回： T 将访问者应用于 MWArray 对象的结果，其具体类型由 <T> 指定。
`classID`	`public MWClassID classID()` 返回此数组的 MATLAB 类型。由以下指定：`MWArray` 类中的 `classID`。返回：该数组的 MWClassID。示例：返回给定数组的 MATLAB 类型： Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("ClassID of A is " + A.classID()); MWArray.disposeArray(A); 输出： ClassID of A is opaque
`clone`	`public java.lang.Object clone() throws java.lang.CloneNotSupportedException` 示例：克隆（深度复制）数组 Hashtable<tring,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); Object C = A.clone(); System.out.println("A = " + A.toString() + ", Clone of A = " + C.toString()); myHash.put("c", new Integer(7)); System.out.println("After change: A = " + A.toString() + ", Clone of A = " + C.toString()); A.set(new Integer(12)); System.out.println("After set: A = " + A.toString() + ", Clone of A = " + C.toString()); MWArray.disposeArray(A); MWArray.disposeArray(C); 初始结果： A = {b=5, a=3}, Clone of A = {b=5, a=3} 修改后结果： A = {b=5, a=3, c=7}, Clone of A = {b=5, a=3, c=7} 组后结果： A = 12, Clone of A = {b=5, a=3, c=7} 覆盖： `MWArray` 类中的 `clone` 返回：MWArray 实例代表底层 MATLAB 数组的深度复制。抛出： java.lang.CloneNotSupportedException 该对象的类没有实现 Cloneable 接口。
`columnIndex`	此方法返回一个数组，其中包含底层 MATLAB 数组中每个元素的列索引。在以下示例中，稀疏 MWArray（由 `newSparse` 方法创建）的内容为： (2,1) 50 (1,2) 10 (2,2) 60 (1,5) 40 (2,5) 90 示例：获取稀疏 MWArray 的列索引获取稀疏数组元素的列索引： System.out.print("Columnindicesare:"); int[]colidx=A.columnIndex(); for(inti=0;i<5;i++) System.out.print(colidx[i]+""); System.out.println(); 输出： Column indices are: 1 2 2 5 5 由以下指定：`MWArray` 类中的 `columnIndex`。返回：索引数组。
`compareTo`	`public int compareTo(java.lang.Object obj)` 此方法将 MWArray 对象与输入对象进行比较。如果 MWArray 对象小于、等于或大于指定对象，则分别返回负整数、零或正整数。示例：使用 compareTo 比较 MWArray 创建 MWArray 对象的共享副本，然后将其与原始对象进行比较。返回值为零表示两个对象相等： Object S = A.sharedCopy(); if (A.compareTo(S) == 0) System.out.println("Matrix S is equal to matrix A"); 输出： Matrix S is equal to matrix A 由以下指定：`java.lang.Comparable` 接口中的 `compareTo`。由以下指定：`MWArray` 类中的 `compareTo`。参数： obj 与此 MWArray 对象进行比较的对象数组。
`dispose`	`public void dispose()` 释放此数组包含的原生 MATLAB 数组。由以下指定：`Disposable` 接口中的 `dispose`。由以下指定：`MWArray` 类中的 `dispose`。
`equals`	`public boolean equals(java.lang.Object obj)` 指示其他数组是否与此数组相等。示例：指示数组是否相等： Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); Hashtable<String,Integer> myHash2 = new Hashtable<String,Integer>(); myHash2.put("a", new Integer(3)); myHash2.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); MWJavaObjectRef B = new MWJavaObjectRef(myHash); MWJavaObjectRef C = new MWJavaObjectRef(myHash2); System.out.println("Do A and B refer to the same object? " + A.equals(B)); System.out.println("Do A and C? " + A.equals(C)); MWArray.disposeArray(A); MWArray.disposeArray(B); MWArray.disposeArray(C); Do A and B refer to the same object? true Do A and C? false 由以下指定：`MWArray` 类中的 `equals`。参数： obj 与此 MWArray 对象进行比较的对象数组。
`get`	`public java.lang.Object get()` 示例：获取有关引用对象的信息 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("A.get() = " + A.get()); System.out.println("Class of referenced object is " + A.get().getClass().toString()); System.out.println("Class of A is " + A.getClass().toString()); MWArray.disposeArray(A); 输出： A.get() = {b=5, a=3} Class of referenced object is class java.util.Hashtable Class of A is class com.mathworks.toolbox.javabuilder.MWJavaObjectRef 返回：引用的对象。
`getData`	`public java.lang.Object getData()` 返回一个一维数组，其中包含底层 MATLAB 数组中数据的副本。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数类型，则 getData 返回实部。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 toArray。示例：使用 getData 获取 MWArray 值从 MWArray 对象 A 获取数据，将类型从 Object 转换为 int： System.out.println("Data read from matrix A:"); int[] x = (int[]) A.getData(); for (int i = 0; i < x.length; i++) System.out.print(" " + x[i]); System.out.println(); 输出： Data read from matrix A: 1 7 13 2 8 14 3 9 15 4 10 16 5 11 17 6 12 18 由以下指定：`MWArray` 类中的 `getData`。返回：按列顺序存储的元素的一维数组。对于非稀疏数组，返回数组的长度等于 MWArray.numberOfElements()；对于稀疏数组，返回数组的长度等于 MWArray.numberOfNonZeros()。
`getDimensions`	`public int[] getDimensions()` 返回包含此数组每一维的大小的数组。此示例使用 3×6 的 MWNumericArray 对象 A，由以下 Java 代码构造： int[][] Adata = {{ 1, 2, 3, 4, 5, 6}, { 7, 8, 9, 10, 11, 12}, {13, 14, 15, 16, 17, 18}}; MWNumericArray A = new MWNumericArray(Adata, MWClassID.INT32); 示例：获取 MWArray 的数组维度 int[] dimA = A.getDimensions(); System.out.println("Dimensions of A are " + dimA[0] + " x " + dimA[1]); 输出： Dimensions of A are 3 x 6 由以下指定：`MWArray` 类中的 `getDimensions`。返回：包含每个维度大小的数组。
`hashCode`	`public int hashCode()` 返回此数组的哈希码值。示例：返回数组的哈希值 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(8)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); int h = A.hashCode(); System.out.println("Hash of A is 0x" + Integer.toHexString(h)); MWArray.disposeArray(A); 输出： Hash of A is 0xffffff33 由以下指定：`MWArray` 类中的 `hashCode`。
`isEmpty`	`public boolean isEmpty()` 如果数组对象不包含元素，则此方法返回 true，否则返回 false。此示例使用 3×6 的 MWNumericArray 对象 A，由以下 Java 代码构造： int[][] Adata = {{ 1, 2, 3, 4, 5, 6}, { 7, 8, 9, 10, 11, 12}, {13, 14, 15, 16, 17, 18}}; MWNumericArray A = new MWNumericArray(Adata, MWClassID.INT32); 示例：测试空的 MWArray 如果数组对象 A 为空数组，则显示一条消息。否则，显示 A 的内容： if (A.isEmpty()) System.out.println("Matrix A is empty"); else System.out.println("A = " + A.toString()); 输出： A= 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 由以下指定：`MWArray` 类中的 `isEmpty`。返回：如果为空则 `true`，否则 `false`
`isSparse`	`public boolean isSparse()` 如果 MWArray 对象是稀疏对象，则此方法返回 true，否则返回 false。以下示例使用的由 newSparse 方法创建的稀疏 MWArray 的内容为： (2,1) 50 (1,2) 10 (2,2) 60 (1,5) 40 (2,5) 90 示例：测试 MWArray 的稀疏性测试先前创建的 MWArray 对象 A 的稀疏性： if (A.isSparse()) System.out.println("Matrix A is sparse"); 输出： Matrix A is sparse 由以下指定：`MWArray` 类中的 `isSparse`。返回：如果为空则 `true`，否则 `false`
`maximumNonZeros`	`public int maximumNonZeros()` 返回稀疏数组的分配容量。如果基础数组是非稀疏的，则此方法返回与 `numberOfElements()` 相同的值。由以下指定：`MWArray` 类中的 `maximumNonZeros`。返回：当前分配的稀疏数组中的非零元素的数量。示例：显示数组中非零元素的最大数量 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("Maximum number of nonzero elements in A is " + A.maximumNonZeros()); MWArray.disposeArray(A); 输出： Maximum number of nonzero elements in A is 1
`numberOfDimensions`	`public int numberOfDimensions()` 返回此数组的维数。此示例使用 3×6 的 MWNumericArray 对象 A，由以下 Java 代码构造： int[][] Adata = {{ 1, 2, 3, 4, 5, 6}, { 7, 8, 9, 10, 11, 12}, {13, 14, 15, 16, 17, 18}}; MWNumericArray A = new MWNumericArray(Adata, MWClassID.INT32); 示例：获取 MWArray 的维数显示数组对象 A 的维数： System.out.println("Matrix A has " + A.numberOfDimensions() + " dimensions"); 输出： Matrix A has 2 dimensions 由以下指定：`MWArray` 类中的 `numberOfDimensions`。返回：维度数。
`numberOfElements`	`public int numberOfElements()` 返回此数组中元素的总数。示例：返回数组中元素的数量 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("Number of elements in A is " + A.numberOfElements()); MWArray.disposeArray(A); 输出： Number of elements in A is 1 由以下指定：`MWArray` 类中的 `numberOfElements`。返回：元素的数量。
`numberOfNonZeros`	`public int numberOfNonZeros()` 返回稀疏数组中非零元素的数量。如果基础数组是非稀疏的，则此方法返回与 `numberOfElements()` 相同的值。由以下指定：`MWArray` 类中的 `numberOfNonZeros`。返回：稀疏数组中当前非零元素的数量。
`rowIndex`	`public int[] rowIndex()` 此方法返回一个数组，其中包含底层 MATLAB 数组中每个元素的行索引。在以下示例中，稀疏 MWArray（由 newSparse 方法创建）的内容为： (2,1) 50 (1,2) 10 (2,2) 60 (1,5) 40 (2,5) 90 由以下指定：`MWArray` 类中的 `rowIndex`。返回：索引数组。
`set`	`public void set(int[] index, java.lang.Object element)` 用指定元素替换此数组中指定的基于 1 的索引数组处的元素。由以下指定：`set` 类中的 `MWArray`。参数： index 指定要替换的元素位置的索引数组。索引数组的长度必须正好是该数组的维数。索引数组的每个元素都有有效范围：1 <= index[i] <= N[i]，其中 N[i] = 第 i 维的大小。 element 索引处要替换的新元素。
`set`	`public void set(int index, java.lang.Object element)` 用指定元素替换此数组中位于指定从 1 开始的偏移量的元素。提供比 public void set(int[] index, Object element) 更好的性能。示例：设置 MWArray 值修改 MWArray 对象 A 中元素 (2, 4) 的数据： int[] index = {2, 4}; A.set(index, 555); Object d_out = A.get(index); System.out.println("Data read from A(2,4) is " + d_out.toString()); 输出： Data read from A(2,4) is 555 由以下指定：`MWArray` 类中的 `set`。参数： index 要替换的元素的索引。有效范围：1 <= 索引 <= N，其中 N = 数组中元素的总数。 element 索引处要替换的新元素。
`set`	`public void set(java.lang.Object o)` 示例：将数组设置为指定值 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("A = " + A.toString()); A.set(new Integer(12)); System.out.println("After set(), A = " + A.toString()); MWArray.disposeArray(A); 初步结果如下： A = {b=5, a=3} 组后结果： A = 12 参数： o 数组应设置为引用的对象。
`setData`	`public void setData(java.lang.Object data)` 由以下指定：`setData` 类中的 `MWArray`。
`sharedCopy`	`public java.lang.Object sharedCopy()` 示例：创建数组的共享副本 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); Object S = A.sharedCopy(); System.out.println("A = " + A.toString() + ", Shared copy of A = " + S.toString()); myHash.put("c", new Integer(7)); System.out.println("After change: A = " + A.toString() + ", Shared copy of A = " + S.toString()); MWArray.disposeArray(A); MWArray.disposeArray(S); 初步结果如下： A = {b=5, a=3}, Shared copy of A = {b=5, a=3} 修改后结果： A = {b=5, a=3, c=7}, Shared copy of A = {b=5, a=3, c=7} 由以下指定：`MWArray` 类中的 `sharedCopy`。返回：MWArray 实例表示底层 MATLAB 数组的共享副本。
`toArray`	`public java.lang.Object[] toArray()` 返回一个包含底层 MATLAB 数组中数据副本的数组。返回的数组具有与底层 MATLAB 数组相同的维度。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数数值类型，则 toArray 返回实部。如果底层数组是稀疏的，则返回数组的完整表示。在具有较大行和列维度的稀疏数组上调用 toArray 时应小心，因为此操作可能会耗尽系统内存。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 toArray。由以下指定：`MWArray` 类中的 `toArray`。返回：与 MATLAB 数组具有相同维数的数组。示例：返回包含底层数组数据副本以及有关数组的附加信息的数组 Integer myInt = new Integer(2); System.out.println("myInts = " + myInt.toString()); MWJavaObjectRef A = new MWJavaObjectRef(myInt); Object[] B = A.toArray(); System.out.println("Array form is an instance of " + B.getClass().toString()); System.out.println("B = " + B); System.out.println("Each element is an instance of " + B[0].getClass().toString()); System.out.println("B[0] = " + B[0]); System.out.println("A is an instance of " + A.getClass().toString()); MWArray.disposeArray(A); 结果如下： myInts = 2 Array form is an instance of class [Ljava.lang.Object; B = [Ljava.lang.Object;@1d53f5b Each element is an instance of class java.lang.Integer B[0] = 2 A is an instance of class com.mathworks.toolbox.javabuilder.MWJavaObjectRef
`toString`	`public java.lang.String toString()` 示例：返回数组的字符串表示形式 Hashtable<String,Integer> myHash = new Hashtable<String,Integer>(); myHash.put("a", new Integer(3)); myHash.put("b", new Integer(5)); MWJavaObjectRef A = new MWJavaObjectRef(myHash); System.out.println("String representation of A is " + A.toString()); MWArray.disposeArray(A); 结果如下： String representation of A is {b=5, a=3} 由以下指定：`MWArray` 类中的 `toString`。
`unwrapJavaObjectRefs`	`public static java.lang.Object[] unwrapJavaObjectRefs(java.lang.Object[] array)` 示例： MWJavaObjectRef A = new MWJavaObjectRef(new Integer(12)); MWJavaObjectRef B = new MWJavaObjectRef(new Integer(104)); Object[] refArr = new Object[2]; refArr[0] = A; refArr[1] = B; Object[] objArr = MWJavaObjectRef.unwrapJavaObjectRefs(refArr); System.out.println("refArr referenced the objects: " + objArr[0] + " and " + objArr[1]); 结果如下： refArr referenced the objects: 12 and 104 返回：引用所指的对象数组。
`unwrapJavaObjectRefs`	`public static java.lang.Object[] unwrapJavaObjectRefs(java.lang.Object[] array)` 示例： MWJavaObjectRef A = new MWJavaObjectRef(new Integer(12)); MWJavaObjectRef B = new MWJavaObjectRef(new Integer(104)); Object[] refArr = new Object[2]; refArr[0] = A; refArr[1] = B; Object[] objArr = MWJavaObjectRef.unwrapJavaObjectRefs(refArr); System.out.println("refArr referenced the objects: " + objArr[0] + " and " + objArr[1]); 结果如下： refArr referenced the objects: 12 and 104 参数：数组需要解开引用的对象数组。返回：引用所指的对象数组。

继承的方法

从类 com.mathworks.toolbox.javabuilder.MWArray 继承的方法。

disposeArray

public static void disposeArray(java.lang.Object obj)

此方法会销毁输入对象中包含的任何原生 MATLAB 数组并释放它们占用的内存。这是类的静态方法，因此不需要引用类的实例来调用。如果输入对象实现了 Disposable 接口，则通过调用其 Disposable.dispose() 方法来释放该对象。如果输入对象代表 Disposable 实例数组，则数组中的每个对象都会被处置。如果输入对象表示 java.lang.Object 数组或多维数组，则会递归处理该数组以释放数组中包含的每个 Disposable 实例。

示例：构造 MWNumericArray 对象

MWArray[] MArr = new MWArray[10];
for (int i = 0; i < 10; i++)
    MArr[i] = new MWNumericArray();
MWArray.disposeArray(MArr);

参数：

obj: 要处理的对象。

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

`finalize`	`finalize()` 当垃圾回收确定没有更多对此对象的引用时，由垃圾回收器对该对象调用。
`getClass`	`public final Class<?> getClass()` 返回此对象的运行时类。
`notify`	`public final void notify()`
`notifyAll`	`public final void notifyAll()` 唤醒正在等待此对象的监视器的所有线程。
`wait`	`public final void wait(long timeout, int nanos) throws InterruptedException` 使当前线程等待，直到另一个线程调用此对象的 `notify()` 方法或 `notifyAll()` 方法，或者某个其他线程中断当前线程，或者已经过了一定的实际时间。

版本历史记录

在 R2006a 中推出