摘要：源碼分析之入口背景去年有個整合多個平臺的項目，底層是華為華等不同平臺的環境，應用管理層為。我們對接華為華等平臺時，對于不同的認證方式，就是使用這種方式，大大減少了開發量。
openstack4j 源碼分析之入口
背景
去年有個整合多個openstack平臺的項目，底層是華為、華3等不同平臺的openstack環境，應用管理層為java。雖然各平臺功能與原生openstack有所增加，但總體接口風格還是openstack的邏輯。由于openstack接口眾多，一個個去適配接口的工作量巨大，所以決定基于openstack的java sdk來開發。對比了幾種常見sdk，最后決定選用openstack4j來開發。
Apache jclouds apache的開源sdk，大而全、雜，可以對接所有常見的云平臺，文檔較少，使用maven引入。
openstack-java-sdk 由愛好者開發及維護的sdk，更新很慢，github的demo已經不能成功連接最新的openstack版本。
openstack4j 官網資料、文檔豐富，接口上手簡單，更新快。
入口
openstack4j的官網demo給出的入口是
OSClient.OSClientV3 os = OSFactory.builderV3()
.endpoint("http://127.0.0.1:5000/v3")
.credentials("admin", "secret", Identifier.byName("Default"))
.scopeToProject(Identifier.byName("admin"))
.authenticate();
OSFactory是一個抽象類，通過它我們可以創建出不同的OSClient，而OSClient則是我們用來操作openstack的接口類。OSClient分為V2和V3版本，對應openstack V2 與 V3版本的認證模塊（Keystone）。
OSClientV2 與 OSClientV3均為OSClient接口類的內部類，通過下面的代碼可以看到，除了在認證模塊有所區別外，其他模塊沒有任何區別。
interface OSClientV2 extends OSClient {
Access getAccess();
org.openstack4j.api.identity.v2.IdentityService identity();
}
interface OSClientV3 extends OSClient {
Token getToken();
org.openstack4j.api.identity.v3.IdentityService identity();
}
OSFactory工廠類是使用建造者模式（Builder Pattern）來將復雜的對象構造過程和主類分離的，具體的對象構造行為是由OSClientBuilder來完成，其中包含了endpoint、credentials、scopeToProject等方法來接收外界傳入的登錄所需信息。
public abstract class OSClientBuilder> implements IOSClientBuilder {
String endpoint;
String user;
String password;
public T endpoint(String endpoint) {
this.endpoint = endpoint;
return (T) this;
}
public T credentials(String user, String password) {
this.user = user;
this.password = password;
return (T) this;
}
登錄信息保存在OSClientBuilder對象中，然后通過authenticate()方法，根據不同的版本進行認證。
public static class ClientV2 extends OSClientBuilder implements IOSClientBuilder.V2 {
@Override
public OSClientV2 authenticate() throws AuthenticationException {
if (tokenId != null) {
checkArgument(tenantName != null || tenantId != null,
"TenantId or TenantName is required when using Token Auth");
return (OSClientV2) OSAuthenticator.invoke(new TokenAuth(tokenId, tenantName, tenantId), endpoint, perspective,
config, provider);
}
if (raxApiKey) {
return (OSClientV2) OSAuthenticator.invoke( new RaxApiKeyCredentials(user, password), endpoint, perspective, config, provider);
}
return (OSClientV2) OSAuthenticator.invoke( new Credentials(user, password, tenantName, tenantId), endpoint, perspective, config, provider);
}
}
public static class ClientV3 extends OSClientBuilder implements IOSClientBuilder.V3 {
@Override
public OSClientV3 authenticate() throws AuthenticationException {
if (tokenId != null && tokenId.length() > 0)
return (OSClientV3) OSAuthenticator.invoke(new KeystoneAuth(tokenId, scope), endpoint, perspective, config,
provider);
return (OSClientV3) OSAuthenticator.invoke(new KeystoneAuth(user, password, domain, scope), endpoint, perspective,
config, provider);
}
}
入口處的代碼主要關聯三個類（接口），OSFactory、OSClientBuilder（IOSClientBuilder）、OSClient，由OSFactory調用OSClientBuilder類構建OSClient對象，然后進行認證，完成了入口處的代碼邏輯。
可以看到，為了避免由于openstack的認證方式更改而帶來的openstack4j認證對象的劇烈改動，入口類之間的耦合很低，易于擴展。使用建造者模式（Builder Pattern）生成認證信息，將復雜的構建與其表示相分離，使得同樣的構建可以創建不同的表示。對于不同的認證方式，只需要增加或者減少部分組合方法即可。
而對于大版本之間的不同，如V2和V3，則使用工廠模式（Factory Pattern），IOSClientBuilder定義一個創建對象的接口，讓其子類自己決定實例化哪一個工廠類，工廠模式使其創建過程延遲到子類進行。當出現認證版本之間的差異時，只需要在IOSClientBuilder接口類中創建自己的靜態工廠接口類，就可以輕松完成認證過程的更改。我們對接華為、華3等平臺時，對于不同的認證方式，就是使用這種方式，大大減少了開發量。
文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。
轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/67201.html
