Формат параметров и выходных значений — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
(Новая страница: «Наверх Взаимодействие осуществляется методами и callback-методам...»)
 
 
(не показано 7 промежуточных версии этого же участника)
Строка 1: Строка 1:
−
[[Встраиваемые_plugin-модули|Наверх]]
+
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Встраиваемые_plugin-модули|Наверх]]
 +
| [[Структура интерфейса|Структура интерфейса<<<]]
 +
| [[Формат параметров и выходных значений|Формат параметров и выходных значений]]
 +
| [[Описание базовых элементов интерфейса|>>>Описание базовых элементов интерфейса]]
 +
|-
 +
|}
  
 
Взаимодействие осуществляется методами и callback-методами с передачей параметров простых типов (<span style="color:blue">BOOL</span>, <span style="color:blue">INT</span>, <span style="color:blue">STRING</span>). В случае необходимости передачи большого числа параметров или сложных параметров используется строковый параметр, содержащий внутри себя XML-структуру. Строка XML установленного образца по умолчанию в кодировке UTF-16. Заголовки жестко фиксированы, содержимое согласно установленной структуре тэгов и их зависимостей, но произвольно по уровням вложенности и комбинациям.  
 
Взаимодействие осуществляется методами и callback-методами с передачей параметров простых типов (<span style="color:blue">BOOL</span>, <span style="color:blue">INT</span>, <span style="color:blue">STRING</span>). В случае необходимости передачи большого числа параметров или сложных параметров используется строковый параметр, содержащий внутри себя XML-структуру. Строка XML установленного образца по умолчанию в кодировке UTF-16. Заголовки жестко фиксированы, содержимое согласно установленной структуре тэгов и их зависимостей, но произвольно по уровням вложенности и комбинациям.  
  
−
  <?xml version="1.0" encoding="utf-16"?>
+
  <nowiki><?xml version="1.0" encoding="utf-16"?>
 
  <oktellcommapper version="80710">
 
  <oktellcommapper version="80710">
 
  <data name="" count="">
 
  <data name="" count="">
Строка 28: Строка 34:
 
   </property_set>
 
   </property_set>
 
  </data>
 
  </data>
−
  </oktellcommapper>
+
  </oktellcommapper></nowiki>
  
  
 
Четыре основных тега внутренней структуры:  
 
Четыре основных тега внутренней структуры:  
  
−
*'''property_simple''' (<property_simple key="" value="" name="" /> ) - элементарные свойства {key,value,name}, value и name могут отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать ( <prs k="" v="" n="">...</prs> ).
+
*<u>'''property_simple'''</u>
  
−
*'''property_cdata''' ( <property_cdata key="" value=""><![CDATA[...]]></property_cdata> ) - полнотекстовые свойства с неизвестным заранее содержимым {key,value,*cdata_text}, value может отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать ( <prc k="" v=""><![CDATA[...]]></prc> ).
+
<nowiki><property_simple key="" value="" name="" /></nowiki>
 +
 +
- элементарные свойства {key,value,name}, value и name могут отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать  
  
−
*'''property_set''' ( <property_set name="" id="">...</property_set> ) - набор произвольного числа property_simple и property_cdata с допустимым присутствием одного тега property_collection. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать ( <s n="" id="">...</s> ).
+
<nowiki><prs k="" v="" n="">...</prs></nowiki>
  
−
*'''property_collection''' ( <property_collection name="" count="">...</property_collection> ) - коллекция произвольного числа property_set. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать ( <с n="" cn="">...</c> ).
 
  
−
Базовый внешний тег <data> представляет собой аналог <property_collection>.
+
*<u>'''property_cdata'''</u>
 +
 
 +
<property_cdata key="" value=""><![CDATA[...]]></property_cdata>
 +
 
 +
- полнотекстовые свойства с неизвестным заранее содержимым {key,value,*cdata_text}, value может отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать
 +
 
 +
<nowiki><prc k="" v=""><![CDATA[...]]></prc></nowiki>
 +
 
 +
 
 +
*<u>'''property_set'''</u>
 +
 
 +
<property_set name="" id="">...</property_set>
 +
 
 +
- набор произвольного числа <span style="color:green">property_simple</span> и <span style="color:green">property_cdata</span> с допустимым присутствием одного тега <span style="color:green">property_collection</span>. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать
 +
 
 +
<nowiki><s n="" id="">...</s></nowiki>
 +
 
 +
 
 +
*<u>'''property_collection'''</u>
 +
 
 +
<property_collection name="" count="">...</property_collection>
 +
 
 +
- коллекция произвольного числа <span style="color:green">property_set</span>. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать
 +
 
 +
<с n="" cn="">...</c>
 +
 
 +
 
 +
Базовый внешний тег <span style="color:green"><data></span> представляет собой аналог <span style="color:green"><property_collection></span>.
  
 
Очевидна объектная модель, лежащая в основе подобным образом организованной структуры. Рекомендация: не делать различий между <span style="color:green">property_simple</span> и <span style="color:green">property_cdata</span> при парсинге XML в объекты.
 
Очевидна объектная модель, лежащая в основе подобным образом организованной структуры. Рекомендация: не делать различий между <span style="color:green">property_simple</span> и <span style="color:green">property_cdata</span> при парсинге XML в объекты.
  
 
В статье [[Объектная модель XML-парсера|«Объектная модель XML-парсера»]] приводится объяснение и формат взаимодействия с классами, обслуживающими XML-структуру описанного образца.
 
В статье [[Объектная модель XML-парсера|«Объектная модель XML-парсера»]] приводится объяснение и формат взаимодействия с классами, обслуживающими XML-структуру описанного образца.
 +
 +
 +
{|cellpadding="10" cellspacing="0" border="0"
 +
| [[Встраиваемые_plugin-модули|Наверх]]
 +
| [[Структура интерфейса|Структура интерфейса<<<]]
 +
| [[Формат параметров и выходных значений|Формат параметров и выходных значений]]
 +
| [[Описание базовых элементов интерфейса|>>>Описание базовых элементов интерфейса]]
 +
|-
 +
|}

Текущая версия на 08:16, 26 марта 2015

Наверх Структура интерфейса<<< Формат параметров и выходных значений >>>Описание базовых элементов интерфейса

Взаимодействие осуществляется методами и callback-методами с передачей параметров простых типов (BOOL, INT, STRING). В случае необходимости передачи большого числа параметров или сложных параметров используется строковый параметр, содержащий внутри себя XML-структуру. Строка XML установленного образца по умолчанию в кодировке UTF-16. Заголовки жестко фиксированы, содержимое согласно установленной структуре тэгов и их зависимостей, но произвольно по уровням вложенности и комбинациям. 

<?xml version="1.0" encoding="utf-16"?>
 <oktellcommapper version="80710">
 <data name="" count="">
   <property_set name="" id="">
     <property_simple key="" value="" name="" />
     .....
     <property_simple key="" value="" name="" />
     <property_cdata key="" value=""><![CDATA[]]></property_cdata>
     .....
     <property_cdata key="" value=""><![CDATA[]]></property_cdata>
     <property_collection name="" count=""> 
       <property_set name="" id="">
          .....
       </property_set>
       .....
       <property_set name="" id="">
          .....
       </property_set>        
     </property_collection> 
   </property_set>
   .....
   <property_set name="" id="">
      .....
   </property_set>
 </data>
 </oktellcommapper>


Четыре основных тега внутренней структуры:

  • property_simple 
<property_simple key="" value="" name="" />

- элементарные свойства {key,value,name}, value и name могут отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать 

<prs k="" v="" n="">...</prs>


  • property_cdata 
<property_cdata key="" value=""><![CDATA[...]]></property_cdata>

- полнотекстовые свойства с неизвестным заранее содержимым {key,value,*cdata_text}, value может отсутствовать. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать 

<prc k="" v=""><![CDATA[...]]></prc>


  • property_set 
<property_set name="" id="">...</property_set>

- набор произвольного числа property_simple и property_cdata с допустимым присутствием одного тега property_collection. В целях уменьшения общего размера названия тегов и атрибутов могут быть сокращены так, что общий вид будет соответствовать 

<s n="" id="">...</s>


  • property_collection 
<property_collection name="" count="">...</property_collection>

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

<с n="" cn="">...</c>


Базовый внешний тег </span> представляет собой аналог <property_collection>.

Очевидна объектная модель, лежащая в основе подобным образом организованной структуры. Рекомендация: не делать различий между property_simple и property_cdata при парсинге XML в объекты.

В статье «Объектная модель XML-парсера» приводится объяснение и формат взаимодействия с классами, обслуживающими XML-структуру описанного образца.


Наверх Структура интерфейса<<< Формат параметров и выходных значений >>>Описание базовых элементов интерфейса

Источник — «https://wiki.oktell.ru/index.php?title=Формат_параметров_и_выходных_значений&oldid=11810»