radadrgen - 手册页部分 1：用户命令

语言：

radadrgen(1)

名称

radadrgen - code generator

用法概要

radadrgen [-h] [-d DIRECTORY] [-k] -l {c,java,python,python27,python35} -s
                   {client,server} [-v]
                   adr

描述

radadrgen 命令是 ADR IDL 处理工具。可用于为 RAD 客户机或服务器实现生成语言绑定。

所有调用均依据 ADR 方案验证给定的文档。

选项

支持以下选项：

–h，–-help

显示帮助消息并退出。

–d DIRECTORY, –-directory DIRECTORY

指定输出目录。如果未指定，则使用当前目录。

–k, –-keep

不覆盖现有输出。如果未指定此标志，radadrgen 将覆盖现有输出文件。

–l {c,java,python27,python35}, –-language {c,java,python27,python35}

指定生成绑定应使用的语言。帮助消息中提供了支持语言列表（包括客户机和服务器端）。

注 - 并非所有语言/端选项都受支持。尝试调用不受支持的组合将导致出现错误消息。

–s {client,server}, –-side {client,server}

Specifies whether bindings should be generated for server-side (skeleton) implementation or client-side (stub).

注 - 并非所有语言/端选项都受支持。尝试调用不受支持的组合将导致出现错误消息。

–v, –-verbose

Reports written filenames.

–J {legacy,camel}, –-java-method-names {legacy,camel}

A private option to switch between a legacy Java method naming scheme where interface property and struct field accessors are named e.g. (get|set)Propertywithlongname() and a camel case one where the same method would be (get|set)PropertyWithLongName().

When omitted, legacy is the default.

操作数

必须在命令行上指定以下操作数：

adr: 必须为其生成类型和接口定义的 API 规范的路径。

示例

示例 1 生成 C 服务器绑定

The following command generates server-side implementation for an adr file, myapi.adr, into the directory server/c:

$ radadrgen -s server -l c -d server/c myapi.adr

如果成功，输出目录将包含 myapi_impl.c 文件、头文件和映射文件。

示例 2 生成 Python 客户机绑定

The following command generates Python client-side bindings for an adr file, myapi.adr, into the directory client/python:

$ radadrgen -s client -l python27 -d client/python myapi.adr

如果成功，输出目录结构的 com/oracle/solaris/rad/ 下将包含 Python 客户机模块 myapi.py。

示例 3 生成 Java 客户机绑定

The following command generates Java client-side bindings for an adr file, myapi.adr, into the directory client/java:

$ radadrgen -s client -l java -d client/java myapi.adr

如果成功，输出目录结构的 com/oracle/solaris/rad/myapi 下将包含用于 API 中定义的接口的一组 .java 文件。

文件

/usr/share/lib/xml/rng/radadr.rng.1: 核心 ADR RelaxNG 方案定义。
/usr/share/lib/xml/rng/radadr-doc.rng.1: 文档元素的 ADR RelaxNG 方案定义。

属性

有关下列属性的说明，请参见 attributes(7)：

属性类型	属性值
可用性	system/management/rad/radadrgen
接口稳定性	Private（专用）

另请参见

attributes(7), rad(8)