摘要：源碼分析之入口背景去年有個(gè)整合多個(gè)平臺(tái)的項(xiàng)目，底層是華為華等不同平臺(tái)的環(huán)境，應(yīng)用管理層為。我們對(duì)接華為華等平臺(tái)時(shí)，對(duì)于不同的認(rèn)證方式，就是使用這種方式，大大減少了開(kāi)發(fā)量。
openstack4j 源碼分析之入口
背景
去年有個(gè)整合多個(gè)openstack平臺(tái)的項(xiàng)目，底層是華為、華3等不同平臺(tái)的openstack環(huán)境，應(yīng)用管理層為java。雖然各平臺(tái)功能與原生openstack有所增加，但總體接口風(fēng)格還是openstack的邏輯。由于openstack接口眾多，一個(gè)個(gè)去適配接口的工作量巨大，所以決定基于openstack的java sdk來(lái)開(kāi)發(fā)。對(duì)比了幾種常見(jiàn)sdk，最后決定選用openstack4j來(lái)開(kāi)發(fā)。
Apache jclouds apache的開(kāi)源sdk，大而全、雜，可以對(duì)接所有常見(jiàn)的云平臺(tái)，文檔較少，使用maven引入。
openstack-java-sdk 由愛(ài)好者開(kāi)發(fā)及維護(hù)的sdk，更新很慢，github的demo已經(jīng)不能成功連接最新的openstack版本。
openstack4j 官網(wǎng)資料、文檔豐富，接口上手簡(jiǎn)單，更新快。
入口
openstack4j的官網(wǎng)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是一個(gè)抽象類，通過(guò)它我們可以創(chuàng)建出不同的OSClient，而OSClient則是我們用來(lái)操作openstack的接口類。OSClient分為V2和V3版本，對(duì)應(yīng)openstack V2 與 V3版本的認(rèn)證模塊（Keystone）。
OSClientV2 與 OSClientV3均為OSClient接口類的內(nèi)部類，通過(guò)下面的代碼可以看到，除了在認(rèn)證模塊有所區(qū)別外，其他模塊沒(méi)有任何區(qū)別。
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）來(lái)將復(fù)雜的對(duì)象構(gòu)造過(guò)程和主類分離的，具體的對(duì)象構(gòu)造行為是由OSClientBuilder來(lái)完成，其中包含了endpoint、credentials、scopeToProject等方法來(lái)接收外界傳入的登錄所需信息。
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對(duì)象中，然后通過(guò)authenticate()方法，根據(jù)不同的版本進(jìn)行認(rèn)證。
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);
}
}
入口處的代碼主要關(guān)聯(lián)三個(gè)類（接口），OSFactory、OSClientBuilder（IOSClientBuilder）、OSClient，由OSFactory調(diào)用OSClientBuilder類構(gòu)建OSClient對(duì)象，然后進(jìn)行認(rèn)證，完成了入口處的代碼邏輯。
可以看到，為了避免由于openstack的認(rèn)證方式更改而帶來(lái)的openstack4j認(rèn)證對(duì)象的劇烈改動(dòng)，入口類之間的耦合很低，易于擴(kuò)展。使用建造者模式（Builder Pattern）生成認(rèn)證信息，將復(fù)雜的構(gòu)建與其表示相分離，使得同樣的構(gòu)建可以創(chuàng)建不同的表示。對(duì)于不同的認(rèn)證方式，只需要增加或者減少部分組合方法即可。
而對(duì)于大版本之間的不同，如V2和V3，則使用工廠模式（Factory Pattern），IOSClientBuilder定義一個(gè)創(chuàng)建對(duì)象的接口，讓其子類自己決定實(shí)例化哪一個(gè)工廠類，工廠模式使其創(chuàng)建過(guò)程延遲到子類進(jìn)行。當(dāng)出現(xiàn)認(rèn)證版本之間的差異時(shí)，只需要在IOSClientBuilder接口類中創(chuàng)建自己的靜態(tài)工廠接口類，就可以輕松完成認(rèn)證過(guò)程的更改。我們對(duì)接華為、華3等平臺(tái)時(shí)，對(duì)于不同的認(rèn)證方式，就是使用這種方式，大大減少了開(kāi)發(fā)量。
文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址：http://m.hztianpu.com/yun/67201.html
