Документация

Используйте MWNumericArray

getmagic программа (Интегрируют Простую функцию MATLAB В приложение Java) преобразует java.lang.Double аргумент к MWNumericArray введите, который может использоваться функцией MATLAB без дальнейшего преобразования:

n = new MWNumericArray(Double.valueOf(args[0]), MWClassID.DOUBLE);
theMagic = new Class1();
result = theMagic.makesqr(1, n);

Передайте Java, дважды возражают

Этот пример вызывает myprimes метод с двумя аргументами. Первое задает количество аргументов, чтобы возвратиться. Вторым является объект класса java.lang.Double это передает один ввод данных myprimes.

cls = new myclass();
y = cls.myprimes(1, Double.valueOf((double)n));

Компилятор преобразует java.lang.Double аргумент к MATLAB double 1 на 1 массив.

Передайте MWArray

Этот пример создает MWNumericArray из типа MWClassID.DOUBLE. Вызов myprimes передает количество выходных параметров, 1, и MWNumericArrayX.

x = new MWNumericArray(n, MWClassID.DOUBLE);
cls = new myclass();
y = cls.myprimes(1, x);

Компилятор преобразует MWNumericArray объект x к скаляру MATLAB double и передачи это к функции MATLAB.

Вызовите методы MWArray

Правила преобразования применяются не только когда вызов ваших собственных методов, но также и при вызове конструкторов и методов фабрики, принадлежащих MWArray классы.

Например, следующий фрагмент кода вызывает конструктора для MWNumericArray класс с Java double как входной параметр:

double Adata = 24;
MWNumericArray A = new MWnumericArray(Adata);
System.out.println("Array A is of type " + A.classID());

Array A is of type double

Компилятор преобразует входной параметр в экземпляр MWNumericArray с ClassID свойство MWClassID.DOUBLE. Этот MWNumericArray объект является эквивалентом MATLAB double 1 на 1 массив.

Возвратите данные от MATLAB до Java

Все данные, возвращенные в метод, закодированный в MATLAB, передаются как экземпляр соответствующего MWArray подкласс. Например, массив ячеек MATLAB возвращен в приложение Java как MWCellArray объект.

Возвратитесь данные не преобразованы в тип Java. Если вы принимаете решение использовать тип Java, необходимо преобразовать в тот тип с помощью toArray метод MWArray разделите на подклассы, которому принадлежат данные о возврате. Для получения дополнительной информации смотрите Использование toTypeArray Методы, чтобы Задать Тип и Размерность.

Значение по умолчанию изменения путем определения типа

При вызове MWArray конструктор метода класса, предоставляя определенный тип данных заставляет MATLAB Compiler SDK преобразовывать в тот тип вместо значения по умолчанию.

Например, в следующем фрагменте кода, код задает тот A должен быть создан как MATLAB 16-битный целочисленный массив 1 на 1:

double Adata = 24;
MWNumericArray A = new MWnumericArray(Adata, MWClassID.INT16);
System.out.println("Array A is of type " + A.classID());

Array A is of type int16

Передайте переменные количества входных параметров

Рассмотрите следующую функцию MATLAB, которая возвращает сумму входных параметров:

function y = mysum(varargin)
y = sum([varargin{:}]);

Входные параметры обеспечиваются как varargin аргумент, что означает, что вызывающая сторона может задать любое количество входных параметров к функции. Результат возвращен как скалярный double.

MATLAB Compiler SDK генерирует следующий интерфейс Java к этой функции:

/* mlx interface - List version*/
public void mysum(List lhs, List rhs)
                          throws MWException
{
   (implementation omitted)
}
/* mlx interface - Array version*/
public void mysum(Object[] lhs, Object[] rhs)
                          throws MWException
{
   (implementation omitted)
}

/* standard interface - no inputs */
public Object[] mysum(int nargout) throws MWException
{
   (implementation omitted)
}

/* standard interface - variable inputs */
public Object[] mysum(int nargout, Object varargin)
                          throws MWException
{
   (implementation omitted)
}

Во всех случаях, varargin аргумент передается как тип Object, который позволяет вам обеспечить любое количество входных параметров в форме массива Объекта (Object[]). Содержимое этого массива передается скомпилированной функции MATLAB в порядке, в котором они появляются в массиве.

Вот пример того, как вы можете использовать mysum метод в программе Java:

public double getsum(double[] vals) throws MWException
{
   myclass cls = null;
   Object[] x = {vals};
   Object[] y = null;

   try
   {
      cls = new myclass();
      y = cls.mysum(1, x);
      return ((MWNumericArray)y[0]).getDouble(1);
   }

   finally
   {
      MWArray.disposeArray(y);
      if (cls != null)
	      cls.dispose();
   }
}

В этом примере вы создаете Object массив длины 1 и инициализирует его ссылкой на предоставленный double массив. Этот аргумент передается mysum метод. Результатом, как известно, является скалярный double, таким образом, код возвращает этот double значение с оператором:

return ((MWNumericArray)y[0]).getDouble(1);

Бросьте возвращаемое значение к MWNumericArray и вызовите getDouble(int) метод, чтобы возвратить первый элемент в массиве как примитивный double значение.

Передайте входные параметры массивов

Эта более общая версия getsum берет массив Object как введено и преобразует каждое значение в double массив. Список double массивы затем передаются mysum функция, где это вычисляет полную сумму каждого входного массива.

public double getsum(Object[] vals) throws MWException
{
   myclass cls = null;
   Object[] x = null;
   Object[] y = null;

   try
   {
      x = new Object[vals.length];
      for (int i = 0; i < vals.length; i++)
         x[i] = new MWNumericArray(vals[i], MWClassID.DOUBLE);

      cls = new myclass();
      y = cls.mysum(1, x);
      return ((MWNumericArray)y[0]).getDouble(1);
   }
   finally
   {
      MWArray.disposeArray(x);
      MWArray.disposeArray(y);
      if (cls != null)
         cls.dispose();
   }
}

Передайте переменное количество Выходных параметров

varargout аргументы обработаны таким же образом тот varargin аргументы обработаны. Рассмотрите следующую функцию MATLAB:

function varargout = randvectors

for i=1:nargout
   varargout{i} = rand(1, i);
end

Эта функция возвращает список случайного double векторизовал таким образом что длина iвектор th равен i. MATLAB Compiler SDK генерирует следующий интерфейс Java к этой функции:

/* mlx interface - List version */
 public void randvectors(List lhs, List rhs) throws MWException
{
   (implementation omitted)
}
/* mlx interface - Array version */
public void randvectors(Object[] lhs, 
           Object[] rhs) throws MWException
{
   (implementation omitted)
}
/* Standard interface - no inputs*/
public Object[] randvectors(int nargout) throws MWException
{
   (implementation omitted)
}

Передайте дополнительные аргументы со стандартным интерфейсом

Вот один способ использовать randvectors метод в программе Java:

 getrandvectors.java

public double[][] getrandvectors(int n) throws MWException
{
   myclass cls = null;
   Object[] y = null;

   try
   {
      cls = new myclass();
      y = cls.randvectors(n);
      double[][] ret = new double[y.length][];

      for (int i = 0; i < y.length; i++)
         ret[i] = (double[])((MWArray)y[i]).getData();
      return ret;
   }

   finally
   {
      MWArray.disposeArray(y);
      if (cls != null)
         cls.dispose();
   }
}

getrandvectors метод возвращает двумерный double массив с треугольной структурой. Длина iстрока th равняется i. Такие массивы обычно упоминаются как зубчатые массивы. Зубчатые массивы легко поддерживаются на Java, потому что матрица Java является только массивом массивов.

Используйте отражение Java, чтобы определить тип и размерность

Этот пример использует toArray метод, чтобы возвратить Java примитивный массив, представляющий базовый массив MATLAB. toArray метод работает точно так же, как getData в предыдущих примерах, за исключением того, что возвращенный массив имеет ту же размерность как базовый массив MATLAB.

Код вызывает myprimes метод и определяет тип с помощью отражения. Пример принимает, что выходной параметр возвращен как числовая матрица, но точный числовой тип неизвестен.

 getprimes.java Используя отражение

public void getprimes(int n) throws MWException
{
   myclass cls = null;
   Object[] y = null;

   try
   {
      cls = new myclass();
      y = cls.myprimes(1, Double.valueOf((double)n));
      Object a = ((MWArray)y[0]).toArray();

      if (a instanceof double[][])
      {
         double[][] x = (double[][])a;

         /* (do something with x...) */
      }

      else if (a instanceof float[][])
      {
         float[][] x = (float[][])a;

         /* (do something with x...) */
      }

      else if (a instanceof int[][])
      {
         int[][] x = (int[][])a;

         /* (do something with x...) */
      }

      else if (a instanceof long[][])
      {
         long[][] x = (long[][])a;

         /* (do something with x...) */
      }

      else if (a instanceof short[][])
      {
         short[][] x = (short[][])a;

         /* (do something with x...) */
      }

      else if (a instanceof byte[][])
      {
         byte[][] x = (byte[][])a;

         /* (do something with x...) */
      }

      else
      {
         throw new MWException(
            "Bad type returned from myprimes");
      }
   }

Используйте запрос MWArray, чтобы определить тип и размерность

Следующий пример использует MWArray classID метод, чтобы определить тип базового массива MATLAB. Это также проверяет размерность путем вызова numberOfDimensions. Если неожиданная информация возвращена, исключение выдается. Это затем проверяет MWClassID и процессы массив соответственно.

 getprimes.java Используя classID

public void getprimes(int n) throws MWException
{
   myclass cls = null;
   Object[] y = null;

   try
   {
      cls = new myclass();
      y = cls.myprimes(1, Double.valueOf((double)n));
      MWClassID clsid = ((MWArray)y[0]).classID();

      if (!clsid.isNumeric() ||
         ((MWArray)y[0]).numberOfDimensions() != 2)
      {
         throw new MWException("Bad type 
                          returned from myprimes");
      }

      if (clsid == MWClassID.DOUBLE)
      {
         double[][] x = (double[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }

      else if (clsid == MWClassID.SINGLE)
      {
         float[][] x = (float[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }

      else if (clsid == MWClassID.INT32 || 
              clsid == MWClassID.UINT32)
      {
         int[][] x = (int[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }

      else if (clsid == MWClassID.INT64 || 
              clsid == MWClassID.UINT64)
      {
         long[][] x = (long[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }

      else if (clsid == MWClassID.INT16 || 
              clsid == MWClassID.UINT16)
      {
         short[][] x = (short[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }

      else if (clsid == MWClassID.INT8 || 
              clsid == MWClassID.UINT8)
      {
         byte[][] x = (byte[][])((MWArray)y[0]).toArray();

         /* (do something with x...) */
      }
   }
   finally
   {
      MWArray.disposeArray(y);
      if (cls != null)
         cls.dispose();
   }
}

Используйте toTypeArray Методы, чтобы Задать Тип и Размерность

Следующий пример демонстрирует, как можно принудить или обеспечить данные к заданному числовому типу путем вызова любого из toTypeМетоды массивов. Эти методы возвращают массив элементов Java типа, заданного от имени вызываемого метода. Данные принуждены или обеспечены к типу примитива, заданному в имени метода. Обратите внимание на то, что при использовании этих методов, данные будут усеченными при необходимости, чтобы позволить соответствие заданному типу данных.

 Задайте Тип Используя toTypeМетод массивов

Object results = null;
try {
    // call a compiled MATLAB function
    results = myobject.myfunction(2);

    // first output is known to be a numeric matrix
    MWArray resultA = (MWNumericArray) results[0];
   double[][] a = (double[][]) resultA.toDoubleArray();

    // second output is known to be 
    //    a 3-dimensional numeric array
    MWArray resultB = (MWNumericArray) results[1];
   int[][][] b = (int[][][]) resultB.toIntArray();   
}
 finally {
    MWArray.disposeArray(results);
}

Передайте объект Java в метод MATLAB Compiler SDK Java

Передать объект в метод MATLAB Compiler SDK Java:

Например:

/* Create an object */
java.util.Hashtable<String,Integer> hash = 
                  new java.util.Hashtable<String,Integer>();
hash.put("One", 1);
hash.put("Two", 2);
System.out.println("hash: ");
System.out.println(hash.toString());
            
/* Create a MWJavaObjectRef to wrap this object */
origRef = new MWJavaObjectRef(hash);
            
/* Pass it to a MATLAB function that lists its methods, etc */
result = theComponent.displayObj(1, origRef);            
MWArray.disposeArray(origRef);

Клонируйте объект

Можно также использовать MWJavaObjectRef клонировать объект путем выполнения следующего:

Например:

origRef = new MWJavaObjectRef(hash);            
System.out.println("hash:");
System.out.println(hash.toString());
result = theComponent.addToHash(1, origRef);
            
outputRef = (MWJavaObjectRef)result[0];
            
/* We can typecheck that the reference contains a      */
/*        Hashtable but not <String,Integer>;          */
/* this can cause issues if we get a Hashtable<wrong,wrong>. */
java.util.Hashtable<String, Integer> outHash = 
          (java.util.Hashtable<String,Integer>)(outputRef.get());
            
/* We've added items to the original hash, cloned it, */
/* then added items to each copy */
System.out.println("hash:");
System.out.println(hash.toString());
System.out.println("outHash:");
System.out.println(outHash.toString());

 addToHash.m

function h2 = addToHash(h)

% Validate input
if ~isa(h,'java.util.Hashtable')
    error('addToHash:IncorrectType', ...
        'addToHash expects a java.util.Hashtable');
end

% Add an item
h.put('From MATLAB',12);
% Clone the Hashtable and add items to both resulting objects
h2 = h.clone();
h.put('Orig',20);
h2.put('Clone',21);

Передайте дату в метод и получите дату из метода

В дополнение к передаче в созданных объектах можно также использовать MWJavaObjectRef передать вспомогательные объекты, такие как java.util.date.

Например:

/* Get the current date and time */
java.util.Date nowDate = new java.util.Date();
System.out.println("nowDate:");
System.out.println(nowDate.toString());
            
/* Create a MWJavaObjectRef to wrap this object */
origRef = new MWJavaObjectRef(nowDate);
            
/* Pass it to a MATLAB function that calculates one week */
/* in the future */
result = theComponent.nextWeek(1, origRef);
            
outputRef = (MWJavaObjectRef)result[0];
java.util.Date nextWeekDate = 
      (java.util.Date)outputRef.get();
System.out.println("nextWeekDate:");
System.out.println(nextWeekDate.toString());

 nextWeek.m

function nextWeekDate = nextWeek(nowDate)

% Validate input
if ~isa(nowDate,'java.util.Date')
    error('nextWeekDate:IncorrectType', ...
        'nextWeekDate expects a java.util.Date');
end

% Use java.util.Calendar to calculate one week later 
% than the supplied 
% java.util.Date
cal = java.util.Calendar.getInstance();
cal.setTime(nowDate);
cal.add(java.util.Calendar.DAY_OF_MONTH, 7);
nextWeekDate = cal.getTime();

Возвратите Объекты Java Используя unwrapJavaObjectRefs

Если вы хотите фактические объекты Java, возвращенные в метод, используйте unwrapJavaObjectRefs. Этот метод рекурсивно соединяет один MWJavaObjectRef или многомерный массив MWJavaObjectRef объекты к ссылке или массиву ссылок.

Следующие фрагменты кода показывают два примера вызова unwrapJavaObjectRefs:

 Возвратите одну ссылку или ссылку на массив объектов Используя unwrapJavaObjectRefs

Hashtable<String,Integer> myHash = new Hashtable<String,Integer>();
myHash.put("a", new Integer(3));
myHash.put("b", new Integer(5));
MWJavaObjectRef A = new MWJavaObjectRef(new Integer(12));
System.out.println("A referenced the object: "
    + MWJavaObjectRef.unwrapJavaObjectRefs(A));
      
MWJavaObjectRef B = new MWJavaObjectRef(myHash);
Object bObj = (Object)B;
System.out.println("B referenced the object: "
    + MWJavaObjectRef.unwrapJavaObjectRefs(bObj))

A referenced the object: 12
B referenced the object: {b=5, a=3}

 Возвращаемый массив ссылок Используя unwrapJavaObjectRefs

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

Пример оптимизации Используя MWJavaObjectRef

Для полного примера того, как использовать MWJavaObjectRef чтобы создать ссылку на объект Java и передать его методу, смотрите Объекты Передачи Java к MATLAB.