// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Краткое руководство пользователя по разработке приложений Java Card
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Краткое руководство пользователя по разработке приложений Java Card - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Краткое руководство пользователя по разработке приложений Java Card

image::images/java-smart-card-sm.jpg[]

_Составитель: Тим Бодро (Tim Boudreau), редактор: Рут Кастерер (Ruth Kusterer)_

Java Card – интересная для работы платформа JVM, работающая на link:http://en.wikipedia.org/wiki/Smart_card[+смарт-картах+] и небольших устройствах, помещающихся на ладони. Java Card 3.0 существует в двух вариантах:

*Классический*:: Такой же, как и более ранние версии Java Card. Платформа крайне ограничена. Например, отсутствует  ``java.lang.String`` , нет метода  ``java.lang.Object.hashCode()`` , и не поддерживаются числа с плавающей точкой.
*Расширенный*:: Новые, более мощные смарт-карты - все это новые возможности Java Card 3.0. Поддерживается более полная реализация платформы Java. Наиболее любопытна встроенная поддержка сервлетов. Можно написать веб-приложение с помощью хорошо знакомого интерфейса API, которое будет выполняться на смарт-карте.


== Требования

*Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.*

image::../../../images_www/articles/68/netbeans-stamp.gif[title="Содержимое этой страницы применимо к IDE NetBeans 6.8 и 6.9"]

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans+] |6.8 

|link:http://java.sun.com/javacard/downloads/index.jsp[+Пакет Java Card SDK+] |3.02 

|Подключаемый модуль Java Card для среды NetBeans |1.3 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработки приложений на языке Java+] (JDK) |Версия 6 
|===


== Настройка среды проекта

Поскольку у смарт-карты отсутствует пользовательский интерфейс, требуется либо иметь устройство чтения смарт-карт для чтения и записи карт, либо использовать эмулятор, включенный в Java Card Reference Implementation (RI). В этом учебном курсе будет использоваться эмулятор.

*Примечание.* Подключаемый модуль Java Card работает в любой операционной системе, но эмулятор Java Card Reference Implementation доступен только для Windows. Тем не менее, можно настроить его как платформу Java на других операционных системах, указав в среде NetBeans на RI, установленный в разделе Windows, в системах Mac или Linux, однако в таком случае не будет возможности запуска приложений.


=== Установка подключаемых модулей в IDE NetBeans

1. Загрузите и установите IDE NetBeans 6.8.
2. После установки в меню "Сервис" выберите пункт "Подключаемые модули".
3. Под заголовком Available Plugins находятся два подключаемых модуля, связанных с Java Card: Java Card и Java Card Runtime Bundle.
* Java Card представляет собой подключаемый модуль, добавляющий поддержку проектов Java Card к IDE NetBeans.
* Java Card 3.0.2 Runtime Bundle требуется только при отсутствии установленной копии Java Card Reference Implementation.

image::images/install-javacard-plugins.png[]


[start=4]
. После установки подключаемого модуля требуется перезапустить среду IDE, а затем продолжить выполнение учебного курса.


=== Регистрация платформы Java Card

Если Java Card 3.0.2 Runtime Bundle был загружен с помощью диспетчера подключаемых модулей, то пакет Java Card SDK уже настроен в качестве платформы. Однако, если платформа была загружена с веб-сайта link:http://java.sun.com/javacard/devkit/[+java.sun.com+], можно использовать меню Tools > Java Platforms, чтобы добавить платформу Java Card в среду IDE так же, как добавляется любая платформа Java.

image::images/installPlatform.png[]

После настройки платформа Java Card появляется на вкладке "Службы" в среде IDE. Если вкладка "Службы" не отображается, выберите пункт "Службы" в меню "Окна".

image::images/services-tab.png[]

На одной "платформе" может быть несколько "устройств". Проект развертывается на конкретном устройстве конкретной платформы.


== Общие сведения о типах проектов Java Card

В меню "Файл" выберите пункт "Создать" и выберите категорию Java Card. Можно создавать несколько типов проектов Java Card. Все они собираются с помощью link:http://ant.apache.org/[+Apache Ant+], так же, как проекты NetBeans Java SE.

image::images/choose-project-type.png[]

Классический апплет — традиционный апплет Java Card для небольших устройств, как апплеты в Java Card 2.0 и ранее. Классическая библиотека подобна классическим проектам апплетов, но без апплета, просто код, который нужно поместить на устройство, который может разделяться между апплетами.

Расширенный апплет и библиотека — то же самое с расширенным API Java Card 3.0, т.е. с возможностью использования java.lang.String и прочего. Загрузочный путь к классам различается для классических и расширенных проектов, поэтому, например, автозавершение кода не будет предлагать java.lang.String в классических проектах, но будет в расширенных.

image::images/create-applet-app.png[]

Проекты веб-приложений - это наиболее интересная и захватывающая функция Java Card 3.0. Пользователи получают проект схемы с реализованным сервлетом и доступ к полному API сервлета. С этими приложениями проще работать, чем с апплетами — на стороне клиента не требуется дополнительный код для взаимодействия с устройством, достаточно веб-браузера. Приложения можно тестировать локально с помощью Reference Implementation и веб-браузера.

image::images/create-web-app.png[]


== [[Работа с проектом]] 

В этом учебном курсе будет создан веб-проект.

В новом веб-проекте введите имя проекта "Веб-приложение Card" и укажите путь к проектам NetBeans. Нажмите кнопку "Готово". Проект отображается на вкладке "Проект".

Щелкните правой кнопкой мыши узел проекта на вкладке "Проект" и выберите в контекстном меню пункт "Свойства". В разделе "Выполнить" окна "Свойства проекта" можно изменить платформу и устройство для развертывания проекта. Нажмите кнопку "Закрыть" для сохранения изменений.

Работа с веб-приложением Java Card похожа на работу с любым веб-приложением, развертываемом в контейнере сервлетов. Нажмите кнопку "Выполнить" на панели инструментов для запуска примера "Hello World". При запуске веб-приложения Java Card открывается веб-браузер с выходным сообщением сервлета:  ``Hello from webapplication1.MyServlet`` .

image::images/editor.png[]

При запуске проектов с типом апплетов в IDE NetBeans можно использовать два удобных интерфейса: вывод данных в командной строке и консоль Java Card. Консоль используется для взаимодействия с апплетом. Можно отправлять данные в шестнадцатеричном формате и получать ответные сообщения.

Совет. RI содержит дополнительные образцы проектов, которые готовы к открытию и запуску в IDE NetBeans.

image::images/run-customizer.png[]


== [[Использование особых возможностей подключаемых модулей]] 

Java Card включает два "магических" понятия, отсутствующих в других платформах Java:

*Идентификаторы приложений (AID)*:: Эти уникальные идентификаторы выглядят следующим образом: //aid//720A75E082/0058AEFC20. Первая часть шестнадцатеричного кода — идентификатор поставщика (его можно получить в link:http://iso.org/[+International Standards Organization (ISO)+]); вторая часть — уникальное значение, выбранное разработчиком. Идентификаторы AID используются для идентификации классов апплетов, пакетов Java (только для классических апплетов и библиотек), уникальных экземпляров апплетов (можно развертывать один апплет многократно на одном устройстве — идентификатор AID экземпляров будет использоваться для выбора апплета).
*Сценарии APDU*:: Это сценарии отправки данных апплету. Они содержат большое количество набранного вручную шестнадцатеричного кода; сценарий должен выбрать конкретный экземпляр апплета и отправить ему данные. Вместо написания сценария можно использовать консоль Java Card.

Хотя эти два момента довольно сложны, подключаемые модули NetBeans помогают абстрагироваться от этих сложностей следующим образом:

* При создании проекта автоматически создаются корректные значения AID апплета, AID классического пакета и один AID экземпляра.

* При переходе на вкладку 'Апплеты' диалогового окна 'Свойства проекта', проект сканирует его путь к классам для всех найденных подклассов апплета карт Java Card:

image::images/customize-applets-pre.png[]

* После их обнаружения можно выбрать в диалоговом окне апплеты, которые действительно развертываются, и настроить значения AID, параметры развертывания и так далее. Введенные значения проверяются средой IDE, поэтому ввести некорректные данные сложно.

image::images/customize-applets.png[]

* Если требуется развертывать два экземпляра одного апплета, можно настроить и такое поведение. Однако в простых случаях, когда нужно развертывать только один экземпляр, нет необходимости задумываться об этом.

image::images/customize-instances.png[]

* Для тестирования апплетов не нужно писать вручную сценарии APDU — можно использовать консоль для прямого взаимодействия с апплетами.

image::images/open-console.png[]

image::images/shell.png[]

* "AID пакета" для классических проектов (в которых может быть только один пакет Java) также обрабатывается средой IDE, но есть возможность настройки.

image::images/create-project-package-aid.png[]

* Часть всех значений AID в проектах — присвоенный организацией ISO ID поставщика (RID). Для ускорения начала работы среда IDE генерирует случайное значение RID, пригодное для разработки и тестирования. При наличии официального RID, можно ввести его в меню "Сервис > Параметры", и оно будет использоваться для всех новых проектов. Нажмите кнопку "Создать" в окне "Свойства проекта" для обновления значений в существующих проектах.

image::images/global-rid.png[]


== [[Взаимодействие с пакетами SDK сторонних поставщиков]] 

В настоящее время средствами поддерживается только Java Card 3.0.2 Reference Implementation, но они имеют расширяемый API для интеграции карт поставщиков. Определения платформы и устройства — простые файлы свойств, импортируемые сценарием сборки.

Развертывание осуществляется с помощью задач Ant, предоставляемых поставщиком смарт-карт. Это означает, что созданные проекты могут выполняться вне среды IDE и жесткая привязка к среде отсутствует. Исходный код задач Ant, являющихся частью Java Card RI, можно загрузить на link:http://kenai.com/projects/javacard[+портале проекта Java Card+] вместе с примерами проектов NetBeans.

Вы поставщик смарт-карт и создали средства развертывания Java Card? Обратитесь к автору подключаемого модуля link:mailto:tboudreau@sun.com[+Тиму Бодро (Tim Boudreau)+] для получения сведений link:http://wiki.netbeans.org/JavaCardPlatformIntegration[+об интеграции смарт-карт+]. Интеграция может осуществляться на нескольких уровнях, в зависимости от потребностей в поддержке карты в среде IDE.

link:/about/contact_form.html?to=6&subject=NetBeans%20Java%20Card%20Development%20Quick%20Start%20Guide[+Отправить отзыв по этому учебному курсу+]


== Дополнительные ссылки

* Авторами этих модулей по большей части является link:http://blogs.oracle.com/javacard/[+Анки Нелатуру (Anki Nelaturu)+] и остальные члены команды Java Card.
* link:http://java.sun.com/javacard[+Официальный портал Java Card Sun+] — новости, инструментарии разработчика, справочные ресурсы, спецификации, разделы часто задаваемых вопросов.
* link:http://kenai.com/projects/javacard/pages/Home[+Портал проекта Java Card+] — исходный код, примеры проектов, форумы, документация.
* link:http://wiki.netbeans.org/JavaCardPlatformIntegration[+Интеграция платформы для поставщиков карт+]
* link:http://java.sun.com/developer/technicalArticles/javacard/javacard-servlets/[+Развертывание сервлетов на смарт-картах: переносные веб-серверы с Java Card 3.0+]