corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Пользовательские компоненты Visual Mobile Designer: создание обозревателя файлов мобильного устройства

Visual Mobile Designer (VMD) — это графический интерфейс в NetBeans Mobility, который позволяет проектировать мобильные приложения, используя перетаскиваемые компоненты. VMD позволяет определять порядок действий в приложении и проектировать графический интерфейс пользователя с использованием компонентов среды IDE или компонентов, разработанных программистом. VMD содержит множество стандартных компонентов интерфейса пользователя, которыми можно воспользоваться для создания приложений, таких как списки, предупреждения, формы и изображения. Он также содержит особые компоненты, упрощающие создание более сложных функций, таких как экран ожидания, заставка, элемент таблицы и других.

Обозреватель файлов — это особый компонент, предоставляющий интерфейс пользователя для работы с файловой системой устройства. Он имеет набор основных функций для обзора содержимого памяти устройств. Этот компонент работает с интерфейсом API FileConnection, входящим в спецификацию JSR-75 PDA Optional Packages для платформы Java ME. JSR-75 не входит в спецификацию MIDP 2.0, поэтому это собственный компонент можно использовать только с устройствами, поддерживающими JSR-75.

Из данного учебного курса вы узнаете, как пользоваться компонентом "Обозреватель файлов" в мобильных приложениях для устройств, поддерживающих JSR-75. Вы познакомитесь с основными особенностями компонентов, научитесь искать содержимое в памяти устройства и отображать содержимое в выбранных текстовых файлах. Кроме особого компонента "Обозреватель файлов", мы будем использовать два других компонента MIDP: Заставка и TextBox.

Примечание. Если вы работаете в NetBeans IDE 6.8, воспользуйтесь учебным курсом Создание обозревателя файлов мобильного устройства в среде IDE NetBeans 6.8.

Содержание

Содержимое этой страницы применимо к среде IDE NetBeans 6.9 или более поздних версий

Для выполнения инструкций данного учебного курса вам потребуются приведённые ниже программное обеспечение и ресурсы.

Программное обеспечение или ресурс Требуемая версия
Среда IDE NetBeans с Java ME 6.9 или более поздняя
Комплект для разработки приложений на языке Java (JDK) 6 или 7

Установка и выполнение демонстрационного приложения

Перед тем как приступить к учебному курсу можно ознакомиться с окончательным результатом этой работы.

Для установки приложения FileBrowserExample выполните следующие действия.

  1. Загрузите архив filebrowserexample.zip.
  2. Распакуйте файл.
  3. В среде IDE выберите Файл > Открыть проект и найдите папку, содержащую распакованные файлы проекта FileBrowserExample.
  4. Нажмите кнопку "Open Project".
    Окно "Проекты" должно выглядеть следующим образом.

    Окно "Проекты" с открытым проектом FileBrowserExample

  5. В окне "Проекты" щелкните правой кнопкой мыши узел проекта и выберите команду Выполнить проект (или нажмите клавишу F6). После запуска приложения откроется окно эмулятора, отображающее это приложение, которое выполняется в эмуляторе устройства по умолчанию.
  6. В окне эмулятора нажмите кнопку под элементом "Launch."
    В окне эмулятора отображается компонент "Заставка" и затем "Обозреватель файлов", как показано ниже.

    Эмулятор WTK 2.5 с примером приложения "Обозреватель файлов"

  • Перемещайте курсор вверх и вниз для перехода по доступным файлам и папкам.
  • Для открытия папки или файла нажмите кнопку под элементом "Select".
  • Для закрытия приложения нажмите кнопку под элементом "Exit".

В начало

Создание приложения с собственным компонентом "Обозреватель файлов"

Теперь, когда вы видели компонент "Обозреватель файлов" в действии, мы вернемся назад к созданию этого приложения. Для создания приложения выполните следующие действия.

  1. Создайте проект FileBrowserExample
  2. Добавьте пакеты и визуальный мидлет в проект FileBrowserExample
  3. Добавьте компоненты в проект FileBrowserExample
  4. Добавьте команды в компоненты TextBox и "Обозреватель файлов"
  5. Соедините компоненты для создания последовательности действий в приложении.
  6. Вставьте метод loadTextFile в исходный код
  7. Запустите проект.

Создание проекта FileBrowserExample

  1. Выберите Файл > Создать проект (Ctrl-Shift-N). В разделе "Категории" выберите JavaME. В разделе "Проекты" выберите "Приложение Mobile" и нажмите кнопку "Далее".
  2. В поле "Имя проекта" введите FileBrowserExample. В поле "Project Location" укажите локальный каталог. Теперь мы будем называть этот каталог $PROJECTHOME.
  3. Снимите флажок с параметра "Create Hello MIDlet". Нажмите кнопку "Далее".
  4. В качестве платформы эмулятора оставьте Sun Java Wireless Toolkit. Нажмите кнопку "Далее".
  5. Нажмите кнопку "Готово".

    Примечание. В папке проекта хранятся все исходные коды и метаданные проекта, такие как сценарий Ant проекта. Само приложение отображается в окне "Flow Design" в Visual Mobile Designer.

Добавление пакетов и визуального мидлета в проект FileBrowserExample

  1. Выберите проект FileBrowserExample в окне "Проекты", затем нажмите Файл > Создать файл (Ctrl-N). В разделе "Категории" выберите "Java Classes". В разделе "File Types" выберите "Java Package". Нажмите кнопку "Далее".
  2. В поле "Имя пакета" введите filebrowserexample. Нажмите кнопку "Готово".
  3. Выберите пакет filebrowserexample в окне проекта, затем выберите Файл > Создать файл (Ctrl-N). В разделе "Categories" выберите "MIDP". В разделе "File Types" выберите "Visual MIDlet". Нажмите кнопку "Далее".
  4. В полях "Имя мидлета" и "Имя класса MIDP" введите FileBrowserExample. Нажмите кнопку "Готово".

Добавление компонентов в проект FileBrowserExample

  1. Переключите свой мидлет на окно Flow Designer. Перетащите следующие компоненты из Палитры компонентов в окно Flow Designer.
    • Splash Screen;
    • TextBox;
    • Обозреватель файлов.
  2. Щелкните элемент splashScreen и в окне "Свойства" измените свойство Text с null на File Browser Example.

Добавление команд в проект FileBrowserExample

  1. Откройте окно Flow Designer.
  2. Выберите команду "Exit" из раздела "Commands" в окне "Component Palette". Перетащите ее в окно Flow Designer (компонент fileBrowser).
  3. Выберите команду "Back" в разделе "Commands" палитры компонентов и перетащите ее в компонент the textBox.

Подключение компонентов для создания последовательности действий приложения

В окне Flow Design щелкните элемент "Start Point" на мобильном устройстве и перетащите его в компонент spalshScreen. Аналогичным образом соедините другие компоненты, как показано на следующем рисунке.

Окно Flow Designer с компонентами, соединенными с помощью командных строк

Вставка предварительного действия в исходный код

  1. Перейдите в окно "Source".
  2. Вставьте следующий код в конец исходного кода. Этот метод отвечает за чтение выбранных файлов: 
        /** 
    * Read file
    */ 
    private void readFile() {
        try {
            FileConnection textFile = fileBrowser.getSelectedFile();
            getTextBox().setString("");
            InputStream fis = textFile.openInputStream();
            byte[] b = new byte[1024];
            int length = fis.read(b, 0, 1024);
            fis.close();
            if (length > 0) {
                textBox.setString(new String(b, 0, length));
            }
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }

  3. Найдите метод commandAction в исходном коде.
    Вставьте readFile(); в раздел предварительного действия FileBrowser.SELECT_FILE_COMMAND (right after: if (command == FileBrowser.SELECT_FILE_COMMAND), где присутствует комментарий: //write pre-action code here).

Выполнение проекта

Для выполнения главного проекта нажмите клавишу <F6> или выберите Выполнить > Выполнить главный проект.

В начало

Документация Java о компоненте "Обозреватель файлов"

Среда NetBeans IDE предоставляет интерфейс API Документация Java для компонента "Обозреватель файлов", а также других компонентов, используемых в VMD. Для ознакомления с документацией Java для компонента "Обозреватель файлов" выполните следующие действия.

  1. Поместите курсор в компонент FileBrowser в исходном коде и нажмите сочетание клавиш Ctr-Shift-Space (или выберите Исходный файл > Показать документацию).
    Во всплывающем меню отобразится документация Java для этого элемента.
  2. Для просмотра подробной информации о компоненте FileBrowser в вашем веб-обозревателе во всплывающем меню щелкните значок "Показать документацию во внешнем веб-обозревателе" (Показать документацию во внешнем веб-обозревателе).

В начало


Дополнительные сведения

В начало