文档WPS Android专业版加解密使用手册 - 图文

4.2 Client规范

Client需要根据一套AIDL接口描述来实现一系列接口，以供Sever调用。 Sever在获得Agent的Client认证列表后，会试着连接列表中的每个Client，直到有一个成功连接。

Client主要实现有三部分组成：OfficeServiceClient 、OfficeAuthorization、OfficeClientEventListener。

OfficeServiceClient 返回OfficeAuthorization和OfficeClientEventListener两个类的实例，以便进行操作。

OfficeAuthorization主要是返回该Client的验证码给Sever以验证Client的有效性。

OfficeClientEventListener主要是实现响应Sever发送的事件（如打开文件）。

下面是这些类的AIDL详细定义： OfficeServiceClient 对象及方法 package cn.wps.moffice.client; import cn.wps.moffice.client.OfficeAuthorization; import cn.wps.moffice.client.OfficeEventListener; interface OfficeServiceClient { } OfficeAuthorization getAuthorization() Client实现此接口被Server调用，返回值为OfficeAuthorization对象，当Client不在服务列表时，返回值为null,则当前Client对象不会得到任何Server的服务及调用请求。 OfficeEventListener getOfficeEventListener() Client实现此接口被Server调用，返回值为OfficeEventListener对象，当Client不在服务列表时，返回值为null,则当前Client对象不会得到任何Server的服务及调用请求。

OfficeAuthorization对象及方法 package cn.wps.moffice.client interface OfficeAuthorization { int getAuthorization( out String[] auth_code ); } AIDL说明： getAuthorization方法： 方法说明： 用于向调用者返回自身的认证码 。Server调用此方法，检测授权码是否正确。如果不正确，该Client将不会接受到任何事件。

OfficeClientEventListener对象及方法 package cn.wps.moffice.client interface OfficeEventListener { int onOpenFile( in String path, in OfficeOutputStream output); OfficeAuthorization getAuthorization(); OfficeEventListener getOfficeEventListener(); int onSaveFile( in OfficeInputStream input, in String path); int onCloseFile(); } onOpenFile( in String path, in OfficeOutputStream output) onOpenFile方法： 方法说明：打开文件事件，打开文件时会调用此方法。 path参数：文件路径。 output参数：Client对path所对应的文件解密，将解密结果写入到output返回值：返回值为-1时，Server将告诉用户，文件无法打开。 onCloseFile方法： 方法说明：关闭文件事件。 int onSaveFile( in OfficeInputStream input, in String path) 方法说明：保存文件事件，保存文件时会调用此方法。 path参数：文件路径。 input参数：Client从input对象中读取数据，对path对应的文件进行加密，返回值：返回值为-1时，Server将告诉用户，文件无法保存。 boolean isActionAllowed(String path, ActionType type) 方法说明：wps外部编辑事件功能，即外部控制wps中某些功能可否操作 Path参数：当前打开文档路径 Type参数：当前事件的类型 返回值：返回该事件是否可以执行。该方式是控制wps某些操作（如保存功能）可否进行，如果返回false，则wps中文档不能保存，否则可以保存操作，如果不需要用到该功能，则直接返回true boolean isValidPackage(String originalPackage, String thirdPackage) 特殊定制需求，直接返回false即可。

注：OfficeInputStream 、OfficeOutputStream 类由Sever实现，在

OfficeClientEventListener打开和保存文件方法使用时，可以像FileInputStream、FileOutputStream一样使用。

对象中，写入完成之后，返回0。解密失败返回-1. int onCloseFile() 加密完成之后，保存到path指向的路径，返回0。加密失败返回-1。