ofbiz minilang(hjd_668翻译)

 

   由于编辑器不好用，所以主要内容在附件中，是doc格式simple-map-processor 和 simple-method XML files  

simple-map-processor的两个主要功能：校验，转换

 

Simple Map Processors Example

<!---->

 
 -
 -
 T
 :
 :
 
 

     

simple-method 是可以被Control Servlet 或 a service 调用的Event的的简单实现

 

 

Sm 可以被作为static 方法调用(调用者可以是Control Servlet or a service)，或者作为一个类调用(调用者可以是Control Servlet or a service)，也可以通过一个Entity 的 controller 配置文件：

 

或一个 service 通过一个entry 在一个 services.xml 文件，像下面：

 location="org/ofbiz/commonapp/party/party/PartyRoleServices.xml" invoke="createPartyRole" auth="true">
 Create a Party Role (add a Role to a Party)
 optional="true"/>
 
 

  

Mini-Language 可以调用 Simple Map Processors, Services and bsh scripts, 操作 entity 相关的操作, and 创建消息返回给调用者. Specific operations can be 附上 in if blocks to execute conditionally and values or fields can be copied around in the maps, lists and method environment.

 

有许多标签可以得到或者设置属性 到/从一个 request 或者 session object 当被作为一个事件调用 或者设置属性作为返回结果当作为一个服务的时候。如果你包含一个env-to-request 操作，它将仅仅被作为一个enent的时候才会被调用 。一个a env-to-result 操作见仅仅被作为一个service时才可以调用。 Everything else is the same when called as an event or a service which makes it easy to write 灵活的逻辑that can be mounted/applied in various ways.

 下面是simple-method标签的完整的属性表:

Attribute Name	Reqd?	Default Value	Description
method-name	Y	N/A	A name (preferably a legal Java identifier) for this method. This name must be unique for the XML file it is in as it will be used to reference this method externally.
short-description	Y	N/A	A short description of the method for certain system error messages.
login-required	N	"true"	Is a logged in user (UserLogin object, or login.username and login.password Strings) required to run this method? "true" or "false".
use-transaction	N	"true"	Create a transaction if none exists for this thread? "true" or "false".
default-error-code	N	"error"	The default error return code.
default-success-code	N	"success"	The default success return code.
parameter-map-name	N	"parameters"	As event: copy of request parameters As service: incoming context
event-request-object-name	N	"request"	(as event only)
event-response-code-name	N	"_response_code_"	(as event only)
event-error-message-name	N	"_error_message_"	(as event only)
event-event-message-name	N	"_event_message_"	(as event only)
service-response-message-name	N	"responseMessage"	(as service only)
service-error-message-name	N	"errorMessage"	(as service only)
service-error-message-list-name	N	"errorMessageList"	(as service only)
service-success-message-name	N	"successMessage"	(as service only)
service-success-message-list-name	N	"successMessageList"	(as service only)
delegator-name	N	"delegator"	A GenericDelegator object to use in the method
security-name	N	"security"	A Security object to use in the method
dispatcher-name	N	"dispatcher"	A LocalDispatcher object to use in the method

---

访问特殊 Contex的语法

访问Map成员，属性field-name="product.productName" 将引用product Map的productName成员，另一种写法是map-name="product" field-name="productName" ，下面的写法更加自由：name="products.widget.productName"，这句将访问products （Map类型）的widget成员(也是一个Map类型)的productName成员

 

访问List 成员，例子：field-name="products[0].productName"将访问products(List类型)的第一个元素的productName属性。为了更有用，，你可以从环境中得到一个List的索引，如：field-name="products[${currentIndex}].productName"，甚至一个Map的引用：field-name="products[${currentIndex}].${currentMember}"

  Call Operations

call-map-processor

 

call-map-processor 标签调用一个简单的map processor 从一个存在的map 或创建一个新的map 或者添加到已经存在的map中去，如果这个名字的out-map 已经存在的话。 Resulting messages 被加入一个命名的 list, 如果这个名字的list不存在的话，一个新的List就会被创建. 记住，同一个context中所有的map和list必须有唯一的名字

  

Attribute Name	Required?	Description
xml-resource	N	The full path and filename on the classpath of the XML file which contains an external map processor to execute. This is only required if an external map processor is desired.
processor-name	N	The name of the external map processor to execute in the specified xml-resource. This is only required if an external map processor is desired.
in-map-name	Y	The name of a map in the method environment to use as the input map.
out-map-name	Y	The name of a map in the method environment to use as the output map. Will be created if it does not exist already. If already exists will be added to in place.
error-list-name	N	The name of a list in the method environment that the error messages will be added to. Will be created if it does not exist. Defaults to "error_list".

 

Sub-Element Name

How Many

<p class="MsoNormal" style="TEXT-ALIGN: left; mso-pagination: widow-o

评论

1 楼 hanjian 2007-11-29  

干啥呢啊？