...
The goal is to support a pattern in service deployment contributors that looks like this:
Code Block |
---|
| java | java |
---|
title | ServiceDeploymentContributor.contributeService |
---|
linenumbers | true |
---|
| java |
---|
|
public void contributeService( DeploymentContext context, Service service ) throws Exception {
List<ServiceParamDescriptor> params = null; // Default if null, otherwise map of per provider role map of name/value pairs.
ResourceDescriptor resource = context.addResource()
resource.role( "WEBHDFS" );
resource.pattern( "webhdfs/v1/**?**" );
context.contributeChain( service, resource, params );
}
|
...
The method below shows a more complete example of a contributeService method as it might be implemented for WebHDFS.
Code Block |
java |
---|
| java |
---|
title | WebHdfsDeploymentContributor.contributeService |
---|
linenumbers | true |
---|
| java |
---|
|
public void contributeService( DeploymentContext context, Service service ) throws Exception {
UrlRewriteRulesDescriptor serviceRules = loadRulesFromClassPath();
UrlRewriteRulesDescriptor clusterRules = context.getDescriptor( "rewrite" );
clusterRules.addRules( serviceRules );
ResourceDescriptor resource;
List<ServiceParamDescriptor> params;
resource = context.getGatewayDescriptor().addResource();
resource.role( "WEBHDFS" );
resource.pattern( "webhdfs/v1/?**" );
resource.pattern( "webhdfs/v1/**?**" );
params = new ArrayList<ServiceParamDescriptor>();
params.add( resource.createParam().role( "rewrite", "request.url", "/webhdfs/namenode/inbound/path" );
params.add( resource.createParam().role( "rewrite", "response.headers", "/webhdfs/namenode/outbound/headers" );
context.contributeChain( service, resource, params );
resource = context.getGatewayDescriptor().addResource();
resource.role( "WEBHDFS" );
resource.pattern( "webhdfs/data/v1/**?**" );
params = new ArrayList<ServiceParamDescriptor>();
params.add( resource.createParam().role( "rewrite", "request.url", "/webhdfs/datanode/inbound/path" );
context.contributeChain( service, resource, params );
}
|
This is a sketch of how topology files would need to be extended to support the external chain definitions.
See table below for details on the new elements introduced.
Note: I don't really like the names for provider-ref and chain-ref but I can't come up with anything better.
Code Block |
xml |
---|
| xml |
---|
title | Sample Topology Descriptor |
---|
linenumbers | true |
---|
| xml |
---|
|
<topology>
<gateway>
<provider>
<role>...</role>
<name>...</name>
<param><name>...</name><value>...</value></param>
</provider>
<chain>
<name>...</name>
<provider-ref>
<role>...</role>
<name>...</name>
<param><name>...</name><value>...</value></param>
</provider-ref>
<provider-ref>...</provider-ref>
</chain>
<chain>...</chain>
</gateway>
<service>
<role>...</role>
<url>...</url>
<chain-ref>
<name>...</name>
<param><role></role><name></name><value></value></param>
</chain-ref>
<param><name></name><value></value></param>
</service>
</topology>
|
...
This shows the new method contributeChain()
that would be added to the DeploymentContext interface.
The existing contributeFilter method would be deprecated.
This is actually a point worth further discussion.
Is there a use case where a service might want to define a chain this way?
Code Block |
java |
---|
| java |
---|
title | DeploymentContext |
---|
linenumbers | true |
---|
| java |
---|
|
public interface DeploymentContext {
...
@Deprecated
void contributeFilter(
Service service,
ResourceDescriptor resource,
String role,
String name,
List<FilterParamDescriptor> params );
void contributeChain(
Service service,
ResourceDescriptor resource,
List<ServiceParamDescriptor> params );
...
}
|
This shows the relevant portions of the existing, unmodified ServiceDeploymentContributor interface.
Code Block |
java |
---|
| java |
---|
title | ServiceDeploymentContributor |
---|
linenumbers | true |
---|
| java |
---|
|
public interface ServiceDeploymentContributor {
...
// Called per service based on the service's role.
void contributeService( DeploymentContext context, Service service ) throws Exception;
...
}
|
This shows the relevant portions of the existing, unmodified ProviderDeploymentContributor interface.
Code Block |
java |
---|
| java |
---|
title | ProviderDeploymentContributor |
---|
linenumbers | true |
---|
| java |
---|
|
public interface ProviderDeploymentContributor {
...
// This will be called indirectly by a ServiceDeploymentContributor when it asks
// for a chain to be contributed via DeploymentContext.contributeChain.
void contributeFilter(
DeploymentContext context,
Provider provider,
Service service,
ResourceDescriptor resource,
List<FilterParamDescriptor> params );
...
}
|