资产代理开发 assets-proxy-development

Adobe Experience Manager Assets使用代理来分发某些任务的处理。

代理是特定的（有时是独立的） Experience Manager 使用代理工作程序作为处理者以处理作业并创建结果的实例。 代理工作程序可用于各种任务。 对于 Experience Manager 资产代理，可用于加载资产以在中渲染 Experience Manager 资产。 例如， IDS代理工作程序 使用InDesign Server处理文件以在中使用 Experience Manager 资产。

当代理是单独的 Experience Manager 实例这有助于减轻 Experience Manager 创作实例。 默认情况下， Experience Manager Assets在同一JVM（通过代理外部化）中执行资产处理任务，以减少 Experience Manager 创作实例。

代理（HTTP访问） proxy-http-access

将HTTP Servlet配置为在以下位置接受处理作业时，可通过HTTP Servlet使用代理： /libs/dam/cloud/proxy. 此Servlet通过已发布的参数创建Sling作业。 然后，该任务将添加到代理作业队列并连接到相应的代理工作程序。

支持的操作 supported-operations

curl -u admin:admin -F":operation=job" -F"someproperty=xxxxxxxxxxxx"
    -F"jobevent=serialized value map" http://localhost:4502/libs/dam/cloud/proxy

curl -u admin:admin -F":operation=result" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502   /libs/dam/cloud/proxy

curl -u admin:admin -F":operation=resource" -F"jobid=xxxxxxxxxxxx"
    -F"resourcePath=something.pdf" http://localhost:4502/libs/dam/cloud/proxy

curl -u admin:admin -F":operation=remove" -F"jobid=xxxxxxxxxxxx"
    http://localhost:4502/libs/dam/cloud/proxy

代理工作程序 proxy-worker

代理工作程序是负责处理作业并创建结果的处理器。 工作程序驻留在代理实例上，且必须实施 sling JobProcessor 将被识别为代理工作者。

客户端API client-api

JobService 可作为OSGi服务使用，该服务提供了创建作业、删除作业以及从这些作业中获取结果的方法。 此服务的默认实施(JobServiceImpl)使用HTTP客户端与远程代理Servlet通信。

以下是API使用示例：

@Reference
 JobService proxyJobService;

 // to create a new job
 final Hashtable props = new Hashtable();
 props.put("someproperty", "some value");
 props.put(JobUtil.PROPERTY_JOB_TOPIC, "myworker/job"); // this is an identifier of the worker
 final String jobId = proxyJobService.addJob(props, new Asset[]{asset});

 // to check status (returns JobService.STATUS_FINISHED or JobService.STATUS_INPROGRESS)
 int status = proxyJobService.getStatus(jobId)

 // to get the result
 final String jsonString = proxyJobService.getResult(jobId);

 // to remove job and cleanup
 proxyJobService.removeJob(jobId);

Cloud Service 配置 cloud-service-configurations

代理和代理工作程序配置均可通过云服务配置使用，可从 Experience Manager 资产 工具 控制台或下 /etc/cloudservices/proxy. 每个代理工作程序应在 /etc/cloudservices/proxy 对于工作人员特定配置详细信息(例如， /etc/cloudservices/proxy/workername)。

以下是API使用示例：

@Reference(policy = ReferencePolicy.STATIC)
 ProxyConfig proxyConfig;

 // to get proxy config
 Configuration cloudConfig = proxyConfig.getConfiguration();
 final String value = cloudConfig.get("someProperty", "defaultValue");

 // to get worker config
 Configuration cloudConfig = proxyConfig.getConfiguration("workername");
 final String value = cloudConfig.get("someProperty", "defaultValue");

开发自定义代理工作程序 developing-a-customized-proxy-worker

的 IDS代理工作程序 是 Experience Manager 已提供开箱即用的资产代理工作程序，用于外包Indesign资产的处理。

您还可以开发和配置自己的 Experience Manager 资产代理工作人员，创建专门工作人员，以派送和外包您的 Experience Manager 资产处理任务。

要设置您自己的自定义代理工作程序，您需要：

下图和步骤详细说明了如何继续：