Адаптер для плагина расширения ExtUI

Плагин расширения ExtUI представляет собой систему динамической генерации объектов и методов API Android. По этой причине он не содержит в себе готового набора виджетов, методов для работы с ним и обработчиков событий, что сократило бы его функциональность.

Вызов методов API Android производится несколько сложнее, чем вызов методов API DroidScript, поскольку для этого требуется точное указание количества аргументов и их типов. С другой стороны, это позволяет постепенно знакомиться с возможностями API Android, что весьма пригодится, если далее планируется освоить разработку мобильных приложений на Java.

Для выполнения примеров на этой странице необходимо установить плагин расширения:

Для проверки работоспособности плагина выполните пример ниже. В нём создаётся кнопка и производится её поворот на 45 градусов.

Выполнить

В данном примере интерфейсная функция плагина расширения runMethodNot вызывается напрямую. Это неудобно, так как при её вызове необходимо указывать тип аргументов. Упрощение вызова достигается при помощи адаптера, который можно реализовать в виде списка функций и метода call, например, setRotation.call( my_object ) или объекта с полиморфной функцией. Для удобства выберем второй вариант.

Создайте новый JavaScript-проект и добавьте в него следующий код.

Добавьте в проект новый файл methods.js, в котором и будет реализован объект-адаптер.

(function(){
    var pr_object = {};
    var pr_plg;

// устанавливает ссылку на плагин
    pr_object.setPlg = function( p_plg ){
        pr_plg = p_plg;
    }

// задаёт обработчик события
    pr_object.setEvent = function( p_object, p_action, p_callback  ){
        
        pr_plg.SetOnEvent( p_object, p_action , p_callback );
        p_callback.this = p_object;
    }

// метод-адаптер для вызова интерфейсного метода плагина runMethodNot
    pr_object.callMethod = function( p_object, p_method ){
    
        var _arg = arguments;
    
        // вызывает метод плагина с требуемым количеством параметров
        function _Call( p_types ){
    
            switch ( _arg.length ){
                case 2:
                    return pr_plg.runMethodNot( p_object, p_method,'');
                break;    
                case 3: 
                    pr_plg.runMethodNot( p_object, p_method, p_types, _arg[2] );
                break;
                case 4: 
                    pr_plg.runMethodNot( p_object, p_method, p_types, _arg[2], _arg[3]);
                break;
                case 5: 
                    pr_plg.runMethodNot( p_object, p_method, p_types, _arg[2], _arg[3], _arg[4] );
                break;
                case 6: 
                    pr_plg.runMethodNot( p_object, p_method, p_types, _arg[2], _arg[3], _arg[4], _arg[5] );
                break;
            }
        }
    
        switch (p_method) {
            case 'getHeight': 
                return _Call();
            break;
            case 'getWidth': 
                return _Call();
            break;
            
            case 'getBottom':
                return _Call();
            break;    
            case 'getLeft':
                return _Call();
            break;    
            case 'getRight':
                return _Call();
            break;    
            case 'getTop':
                return _Call();
            break;    
    
            
            case 'getPaddingBottom':
                return _Call();
            break;    
            case 'getPaddingEnd':
                return _Call();
            break;    
            case 'getPaddingLeft':
                return _Call();
            break;    
            case 'getPaddingRight':
                return _Call();
            break;    
            case 'getPaddingStart':
                return _Call();
            break;    
            case 'getPaddingTop':
                return _Call();
            break;    
            
            case 'getLayoutDirection':
                return _Call();
            break;  
            
            case 'getMinimumHeight':
                return _Call();
            break;  
            case 'getMinimumWidth':
                return _Call();
            break;  
            
            case 'setGravity': 
                _Call( "int" );
            break;
            
            case 'getRotation': 
                return _Call(); 
            break;
            case 'setRotation': 
                _Call( 'float' ); 
            break;
            
            case 'getScaleX': 
                return _Call(); 
            break;
            case 'getScaleY': 
                return _Call(); 
            break;
    
            case 'getTextAlignment': 
                return _Call(); 
            break;
            case 'setTextAlignment': 
                _Call( 'int' ); 
            break;
            
            case 'getTextDirection': 
                return _Call(); 
            break;
            case 'setTextDirection': 
                _Call( 'int' ); 
            break;
    
            case 'isChecked': 
                return _Call(); 
            break;
            case 'setChecked': 
                _Call( 'boolean' ); 
            break;
    
            case 'setPressed': 
                _Call( "boolean" );
            break;
            case 'setText': 
                _Call( "CharSequence" );
            break;
            case 'setMinimumHeight': 
                _Call( "int" );
            break;
            case 'setMinimumWidth': 
                _Call( "int" );
            break;
            case 'setPadding': 
                _Call( "int,int,int,int" );
            break;
        }
    }    
    window.controls.api = pr_object;

})();

Код получился объёмным, но его основная часть состоит из перечня вызовов функций _Call, аргументы для которой берутся из заголовков соответствующих методов API Android. Получить их можно при помощи метода плагина GetMethods:

, или из справочника разработчика Android. Например, заголовок метода setPadding выглядит так:

Для вызова этого метода ему нужно передать 4 аргумента типа int. Перечисляем типы в строке через запятую и получаем требуемый аргумент для нашей функции _Call:

Функциональность адаптера зависит от того, сколько методов в нём реализовано. Можно реализовать адаптер с ограниченным набором методов под тот или иной проект или один большой с максимально возможным их количеством, наполняя его постепенно.

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

Прямой вызов интерфейсной функции плагина

Преимущества