Spec-Zone .ru спецификации, руководства, описания, API

Содержание документации

Соединение и Детали Вызова                         

Содержание

Транспорты

В пределах JPDA приложение отладчика использует Интерфейс Отладки Java (JDI) интерфейс и абстракция Соединителя, чтобы установить соединение с целевым VM. Соединитель, используемый приложением отладчика, инкапсулирует транспорт. На целевом VM агент, поддерживающий Протокол Провода Отладки ^JavaTM, используется, чтобы связаться с отладчиком. Этот агент (который может быть встроен в целевой VM или загружен из библиотеки времени выполнения) инкапсулирует транспорт, чтобы связаться с отладчиком.

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

Транспорт сокета

Команда и пакеты ответа пишутся потоку в соответствии со спецификацией JDWP, используя Транспортный Интерфейс JDWP. Так как много маленьких пакетов могут быть отправлены по JDWP, опция сокета TCP_NO_DELAY может улучшить производительность в некоторых реализациях сокета, избегая задержек, которые могли произойти, если реализация сокета буферизует маленькие пакеты прежде, чем отправить им. Сокеты закрываются корректно так, чтобы неотправленный данные был отправлен если возможный.

Транспорт сокета идентифицируется через уникальную строку, dt_socket. Это имя может использоваться, чтобы выбрать транспорт сокета, вызывая целевой VM. В пределах приложения отладчика используется соответствующий Соединитель, который инкапсулирует транспорт сокета.

В контекстах, где клиент присоединяет к серверу, у транспортных адресов сокета есть формат "<name>:<port>", где <name> является именем хоста, и <port> является номером порта сокета, в котором это присоединяет или слушает. В контекстах, где сервер ожидает клиента, чтобы присоединить, адрес состоит из одного только номера порта (имя хоста неявно).

Транспорт Совместно используемой памяти

Транспорт совместно используемой памяти идентифицируется через уникальную строку, dt_shmem. Это имя может использоваться, чтобы выбрать транспорт сокета, вызывая целевой VM. В пределах приложения отладчика используется соответствующий Соединитель, который инкапсулирует транспорт совместно используемой памяти.

Транспортные адреса совместно используемой памяти являются просто именами, которые могут использоваться в качестве имен объектов отображения файла Microsoft Windows. Строка имени может состоять из любой комбинации символов, исключая наклонную черту влево.

Соединители

Хорошее клиентское приложение JDI позволит пользователям выбирать и конфигурировать любой соединитель, который может присутствовать, но это может быть выгодно, чтобы включить знание определенных соединителей в отладчик, чтобы сделать их конфигурацию более приятным пользовательским опытом. Пример реализация JDB, предоставленная JPDA, иллюстрирует этот подход.

Ссылочные реализации JDI обеспечивают несколько соединителей, которые отображаются на доступные транспортные типы и режимы соединения (запуск, слушание, и присоединение). Эти соединители описываются в следующих разделах. Список, содержащий эти соединители, возвращается методом JDI VirtualMachineManager.allConnectors (). Кроме того, каждое присоединение, слушание, и запуск соединителя содержатся в списках, возвращенных соответствующими методами VirtualMachineManager attachingConnectors (), listeningConnectors (), и launchingConnectors ().

Соединитель Запуска Командной строки Sun

Этот соединитель однозначно определяется именем "com.sun.jdi. CommandLineLaunch".
 

Необработанный Соединитель Запуска Командной строки

Этот соединитель однозначно определяется именем "com.sun.jdi. RawCommandLineLaunch".
 

Соединитель Присоединения сокета

Этот соединитель однозначно определяется именем "com.sun.jdi. SocketAttach".
 

Соединитель Присоединения Совместно используемой памяти

Этот соединитель однозначно определяется именем "com.sun.jdi. SharedMemoryAttach".
 

Сокет Слушая Соединитель

Этот соединитель может принять соединения от многократного целевого VMs.

Этот соединитель однозначно определяется именем "com.sun.jdi. SocketListen".
 

Совместно используемая память Слушая Соединитель

Этот соединитель может принять соединения от многократного целевого VMs.

Этот соединитель однозначно определяется именем "com.sun.jdi. SharedMemoryListen".
 

Соединитель Присоединения процесса

Ядро SA Присоединение Соединителя

        
${JAVA_HOME}/bin/rmiregistry -J-Xbootclasspath/p:${JAVA_HOME}/lib/sa-jdi.jar

${JAVA_HOME}/bin/java \ 
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pid> \
    [uniqueID]

${JAVA_HOME}/bin/java \
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pathname to the java executable that produced the core file>\
    <pathname of the corefile to debug> \
     [uniqueID]

Sun Опции Вызова VM

Реализации Sun VM требуют, чтобы параметры командной строки загрузили агент JDWP для того, чтобы отладить. От 5.0 вперед опция -agentlib:jdwp используется, чтобы загрузить и определить опции к агенту JDWP. Для выпусков до 5.0, опции -Xdebug И -Xrunjdwp используются (5.0 реализаций также поддерживают опции -Xdebug И -Xrunjdwp, но более новая опция -agentlib:jdwp предпочтительна как агент JDWP в 5.0 использовании интерфейс TI JVM к VM, а не более старый интерфейс JVMDI).

Если Ваше приложение отладчика будет использовать Соединитель Запуска Командной строки Sun JDI, то соединитель будет использовать опции -Xdebug И -Xrunjdwp, как Соединитель может использоваться, чтобы соединиться с пред5.0 целевыми VM.

Если целевой VM 5.0 или более нов, опция -agentlib:jdwp определяется следующим образом:

-agentlib:jdwp=<sub-options>

Загружает ссылочную реализацию JPDA JDWP. Эта библиотека находится в целевом VM и использует TI JVM и JNI, чтобы взаимодействовать с этим. Это использует транспорт и протокол JDWP, чтобы связаться с отдельным приложением отладчика. Определенные подопции описываются ниже.

Для выпусков до 5.0 используются опции -Xdebug И -Xrunjdwp:

-Xdebug

Отладка включений

-Xrunjdwp:<sub-options>

Загружает ссылочную реализацию JPDA JDWP. Эта библиотека находится в целевом VM и использует JVMDI и JNI, чтобы взаимодействовать с этим. Это использует транспорт и протокол JDWP, чтобы связаться с отдельным приложением отладчика. Определенные подопции описываются ниже.

-agentlib:jdwp и-Xrunjdwp подопции

   -agentlib:jdwp=<name1>[=<value1>],<name2>[=<value2>]...

или

   -Xrunjdwp:<name1>[=<value1>],<name2>[=<value2>]...

Таблица ниже описывает опции, которые могут использоваться:
 

Примеры

-agentlib:jdwp=transport=dt_socket,server=y,address=8000

Прислушайтесь к сокетному соединению на порту 8000. Приостановите этот VM перед основными загрузками класса (suspend=y по умолчанию). Как только приложение отладчика соединяется, оно может отправить команду JDWP, чтобы возобновить VM.

-agentlib:jdwp=transport=dt_socket,server=y,address=localhost:8000,timeout=5000

Прислушайтесь к сокетному соединению на порту 8000 на петлевом адресе только. Оконечный, если отладчик не присоединяет в течение 5 секунд. Приостановите этот VM перед основными загрузками класса (suspend=y по умолчанию). Как только приложение отладчика соединяется, оно может отправить команду JDWP, чтобы возобновить VM.

-agentlib:jdwp=transport=dt_shmem,server=y,suspend=n

Выберите доступный транспортный адрес совместно используемой памяти и напечатайте его к stdout. Прислушайтесь к соединению совместно используемой памяти в том адресе. Позвольте VM начинать выполняться перед присоединениями приложения отладчика.

-agentlib:jdwp=transport=dt_socket,address=myhost:8000

Присоедините к рабочему приложению отладчика через сокет на узле myhost в порту 8000. Приостановите этот VM перед основными загрузками класса.

-agentlib:jdwp=transport=dt_shmem,address=mysharedmemory

Присоедините к рабочему приложению отладчика через совместно используемую память в транспортном адресе "mysharedmemory". Приостановите этот VM перед основными загрузками класса.

-agentlib:jdwp=transport=dt_socket,server=y,address=8000,onthrow=java.io.IOException,launch=/usr/local/bin/debugstub

Ожидайте экземпляра java.io. IOException, который будет брошен в этот VM. Приостановите VM (suspend=y по умолчанию). Прислушайтесь к сокетному соединению на порту 8000. Выполните следующее: "/usr/local/bin/debugstub dt_socket myhost:8000"., Эта программа может запустить процесс отладчика в отдельном окне, которое присоединит к этому VM и начнет отлаживать его.

-agentlib:jdwp=transport=dt_shmem,server=y,onuncaught=y,launch=d:\bin\debugstub.exe

Ожидайте непойманного исключения, которое будет брошено в этот VM. Приостановите VM. Выберите транспорт совместно используемой памяти, адресуются и прислушиваются к соединению в том адресе. Выполните следующее: "d:\bin\debugstub.exe dt_shmem <address>", где <address> является выбранным адресом совместно используемой памяти. Эта программа может запустить процесс отладчика в отдельном окне, которое присоединит к этому VM и начнет отлаживать его.

Отладка Сменных Апплетов

JDI запускающиеся соединители не может использоваться, чтобы отладить Сменные апплеты.

Соединение с JDB

В JDB - опция присоединения обеспечивает доступ к одному из соединителей присоединения в ссылочной реализации (совместно используемая память на Microsoft Windows, сокеты на Солярисе и платформах Linux). - слушают, опция обеспечивает доступ к одному из соединителей слушания в ссылочной реализации (совместно используемая память на Microsoft Windows, сокеты на Солярисе и платформах Linux). Имя класса и параметры, определенные непосредственно на командной строке, обеспечивают доступ к соединителю запуска командной строки Sun.

Например:

jdb -attach myhost:8000

легкий способ присоединить к целевому VM с Соединителем Присоединения Сокета (на операционной среде Соляриса), и

jdb Hello 1 2 3

легкий способ запустить целевой VM с Соединителем Запуска Командной строки Sun.

Однако, - возможность подключения также предоставляется JDB, чтобы обработать любой соединитель, беря имя соединителя и ряд произвольных пар параметра имени/значения. Например у командных строк выше есть следующие эквиваленты.

jdb -connect com.sun.jdi.SocketAttach:hostname=myhost,port=8000
jdb -connect "com.sun.jdi.CommandLineLaunch:main=Hello 1 2 3"

Эти командные строки являются более громоздкими чем те выше, но - опция подключения может использоваться с любым соединителем. Этот вид работы является примитивным примером того, как отладчик JDI может иметь дело с любым видом соединителя, обеспечивая упрощенный интерфейс для того, чтобы он имел дело с общими, известными соединителями.

Интерфейсы Поставщика услуг

JPDA включает интерфейсы поставщика услуг, чтобы позволить разработку и развертывание соединителя и транспортные реализации. Эти интерфейсы поставщика услуг позволяют отладчик, и другие поставщики инструмента разрабатывают новые реализации соединителя и обеспечивают дополнительные транспортные механизмы и вне сокета и транспорта совместно используемой памяти, обеспеченного Sun. Интерфейсы поставщика услуг в JDI определяются в com.sun.jdi.connect.spi пакете.

В дополнение к интерфейсам поставщика услуг в JDI реализация Sun также включает транспортный интерфейс библиотеки, названный Java Транспортный Интерфейс Протокола Провода ^TMDebug. Транспортная библиотека загружается агентом JDWP в целевом VM и пользуется, чтобы установить соединение с отладчиком и транспортировать пакеты JDWP между отладчиком и VM.

Дополнительная информация об интерфейсах поставщика услуг может быть в документе Архитектурой Отладчика Платформы ^JavaTM - Интерфейсы Поставщика услуг.

---

Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Свяжитесь с Нами