Skip to main content

JBoss FSW 6 - Switch Yard 小程式

這篇本來更早就寫好想要放上來,可惜在Alpha版本不是很穩定的狀況下,我還是等到Beta 才把這篇放出來給大家看。

JBoss SOA 正式改名為 Fuse Service Work, 所以以後 FSW 就是SOA拉~ 在這裡正名一下。
前些日子本來很想寫這篇,現在終於可以補上來了。

建議你在開始這個小程式之前,先去看一下SwitchYard 的基礎介紹。按這裡
安裝工具,與JBoss FSW 因為Beta版的installer 還有在改東西,所以我等他們改好以後再放好了。(有空再寫 :p 忙忙忙忙忙... )

首先,按下滑鼠右鍵,建立一個SwitchYard專案。


輸入這個Project的名字。

選擇FSW 的版本,與裡面會用到元件。
(PS, 我抓圖的時候還在Alpha, 但是Final ㄧ)



在一個SwitchYard 的專案中的META-INF 會有一個重要的檔案,switchyard.xml,這個檔案就是整個AP的定義檔,例如說,從哪裡會有Data 近來,送到哪裡處理,以及處理完的資料要送到哪裡等等... 在 JBoss Developer Studio 裡面,可以透過GUI的工具看到這個定義的內容,然後也可以拖拉的把資料加入。

現在開始寫拉,把Bean 也就是主要的Java程式邏輯拖拉到Composite(組合)上。


當把Bean拖拉上去時,會自動跳出一個請你輸入Bean資訊的視窗,請點選 interface (這是一個合約).


輸入interface名稱後,按確認。它會自動幫你產生對應的Bean 還有 Service (合約)名稱。

按下確認後就可以在對應的Folder下看到產出的java檔案。


打開Payments.java, 這是一個合約的interface, 現在,請在裡面定義這個payments 合約可以有whopay這個動作。

Payments.java
package com.example.switchyard.ChristinaDemo;

public interface Payments {

 void whatInterestRate(Customer customer);
}

因為payments只是一個合約,實作的內容還是要寫在Bean裡面。

PaymentsBean.java
package com.example.switchyard.ChristinaDemo;

import org.switchyard.component.bean.Service;

@Service(Payments.class)
public class PaymentsBean implements Payments {

 @Override
 public void whatInterestRate(Customer customer) {
  if(customer.creditRating > 300){
      System.out.println("10%");
   
  }else{
   System.out.println("30%");
 
  }
 }

}


裡面有個Customer 的物件,如下:

Customer.java
package com.example.switchyard.ChristinaDemo;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Customer {

 int creditRating;
 boolean isVIP;
 
 public int getCreditRating() {
  return creditRating;
 }
 public void setCreditRating(int creditRating) {
  this.creditRating = creditRating;
 }
 public boolean isVIP() {
  return isVIP;
 }
 public void setVIP(boolean isVIP) {
  this.isVIP = isVIP;
 } 
 
}


以上三個Java 完成後,我們就完成一個元件服務,現在,就開始定義到底資料要如何送入這個服務中。請在你的compenent service上的綠色小箭頭上按下滑鼠右鍵。點選,promote service.


會自動跳出要promote成對外什麼服務的選擇視窗,我們要對外開放成Web Service, 所以請選WSDL.然後按下interface。


按下之後,它會自動跳出這次幫你建立Web Service WSDL 的儲存位置,請按Next 往下一步。


我喜歡把Web Service 名稱叫做XXXService, 所以就把service name 改成 PaymentService,按Finish 完成這個步驟。


這時它就會跳回去一開始我們想要建立Web Service 的 Promote Component Service 的畫面。請按下一步,



因為Web Service 收的是XML, 而我們收的是Java 物件,所以一定要做一個轉換資料的動作,一般來說,XML 轉物件選 JAXB 就可以了。但是這次我選Java Transformer, 這樣,以後有特殊需求,我可以自己改動轉換內容。按下一步繼續


之後他會跳出幫你自動建立轉換的Java程式 GUI 畫面,在Name 裡面填上PaymentTransformer即可。


之後,再打開的 PaymentTransformer 裡面,寫以下轉換的程式碼。
package com.example.switchyard.ChristinaDemo;

import org.switchyard.annotations.Transformer;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

public final class PaymentTransformer {

	@Transformer(from = "{urn:com.example.switchyard:ChristinaDemo:1.0}whatInterestRate")
	public Customer transformWhatInterestRateToCustomer(Element from) {
		
		int creditRating = Integer.parseInt(from.getElementsByTagName("creditRating").item(0).getChildNodes().item(0).getNodeValue());
		boolean isVIP = Boolean.parseBoolean(from.getElementsByTagName("creditRating").item(0).getChildNodes().item(0).getNodeValue());
		System.out.println("creditRating:["+ creditRating+"]");
		System.out.println("isVIP:["+ isVIP+"]");
		
		Customer customer = new Customer();
		customer.setCreditRating(creditRating);
		customer.setVIP(isVIP);
		
		return customer;
	}
}
現在,基本上完成了,可是,我們剩最後一步,還沒有定義Web Service 是使用哪種通訊協定出去的,一般Web Service 都是走SOAP, 所以我們就把最左手邊的Binding SOAP 拖拉到剛剛建立的PayementService(Composite Service) 上。
這一步可以都照預設值拉~看你.. 
這樣就完成拉!!!!! 把剛剛做好的ChristinaDemo Project 丟到 FSW 的Server 上。
看到剛剛設定的 PayamentService 正確的啓動,就可以開始測試囉~
透過工具,發一個XML,裡面的Credit Rating 是 400 
Log 上寫 10% , 沒錯,跟我寫的邏輯是一樣的。
再發一個XML,裡面的Credit Rating 是 100
Log 上寫 30%,哇哈哈~正確無誤,收工!
以上。

Comments

Popular posts from this blog

Red Hat Fuse - Announcing Fuse 7 Tech preview 3 release.

Red Hat Fuse 7.0 technical preview three is out today! On the pathway to become one of the best cloud-native integration platform, Fuse gives developer freedom to choose how they want to develop the integration solution, where they want to deploy it and capabilities to address new integration personas that do not have development experience.
By supporting the three major runtime, developer is free to work on the runtime of their choice.By supporting standalone and cloud deployment, it simplifies the complexity to distinguish between these environments, allowing application to deploy freely among the environment of your choice. All levels of developers are welcome, you can either dive deep into creating customize complex integration logic, or using the new low code platform to quickly build a simple integration. In this Tech Preview release you get it all.
Fuse StandaloneSpring-boot for microserviceKaraf 4 for OSGi loverJBoss EAP for JavaEE developersFuse on OpenShiftPlugins for easy co…

JBoss EAP 6 - 效能調校 (一) DataSource 的 Connection Pool

效能沒有什麼Best Practice, 反正能調整的就那些。 通常,一個程式的效能大概有70-80% 都跟程式怎麼寫的其實比較有關係。

最近我最疼愛的小貓Puji 因為膀胱結石開刀的時候過世了,心情很差請原諒我的口氣沒有很好,也沒有心情寫部落格。

Puji R.I.P.

=======================正文=======================

這個題目很多人叫我寫,可是這題目好大,這分明就是整死我咩~
所以我會分幾段慢慢寫。

JBoss 的 SubsystemDatasource WebWeb Service EJB Hibernate JMSJCAJVM 調校OS (作業系統)

先來看一下 DataSource Subsystem, DataSource 的部分主要是針對Connection Pool 做調校。

通常,程式都會需要跟資料庫界接,電腦在本機,尤其是在記憶體的運算很快,但是一旦要外部的資源連接,就是會非常的耗資源。所以現在的應用程式伺服器都會有個Pool 放一些先連接好的 資料庫connection,當程式有需要的時候就可以馬上提供,而不用花那些多餘的資源去連接資料庫。

這就是為什麼要針對Connection Pool 去做調校。

以下會討論到的參數,都是跟效能比較有關係,Datasource 還有很多參數,像是檢核connection 是否正確的,我都不會提到。如果你追求的是非常快速的效能,那我建議你一個檢核都不要加。當然,這樣就會為伺服器上面執行的程式帶來風險。這就是你要在效能與正確,安全性上面的取捨了。 (套句我朋友說的話,不可能又要馬兒好,又要馬兒不吃草的..)

最重要的調校參數就是 Connection 的 Pool 數量。(也就是那個Pool 裡面要放幾條的connection.) 這個參數是每一個應用程式都不一樣的。

min-pool-size 

Connection Pool 最少會存留的connection 數量

max-pool-size 

Connection Pool 最多可以開啓的 connection 數量

prefill

事先將connection pool 裡面建立好min-pool-size 的connection.

我的建議是觀察一下平常程式要用到的量設定為 min-pool-size 。
加上…

Fuse - Contract First API Design with Apicurio and Fuse/Camel - Part One

This is part one of my two-article series that demonstrates the approach of implementing contract-first API design using Apicurioand Red Hat Fuse.

It covers how to create an OpenAPI standard document as the contract between API providers and consumers using Apicurio. It also shows how to quickly create mock tests using Red Hat Fuse.

There are two common approaches of creating these APIs.
Code FirstContract First Coming from a old time ESB developer, these are not new. We have been doing this forever. Before, it was the WSDL that define the contract of the service. we were doing a lot more code first, for me it's simply because it's much easier for me to write couple of Java classes and generate the WSDL for my consumer. 

It's often pretty straightforward if the consumer of your application has finalized how they want the service to be like. But you and I all know this is not often the case. So I had to go back to my code, and make the changes accordingly and pray I did not …