asakusa framework はじめの一歩 ( ver 0.6.2 )

A s a k u s a F r a m e w o r k はじめの一歩（ v e r 0 . 6 . 2）

前提

• Jinrikishaダウンロードページを参考に、Jinrikisha、Shahu、DmdlEditorX、ToadEditorをインストールしてください

http://asakusafw.s3.amazonaws.com/documents/jinrikisha/ja/html/index.html

• Mac OS X 10.9.4、Java 1.6.0_65

• Asakusa Framework 0.6.2

2

本件で作成するジョブ

3

4

H D F S

A s a k u s a A p p l i c a t i o n

4

H D F S

A s a k u s a A p p l i c a t i o n

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

Impo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

Impo

rter

Expo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

J o b F l o wIm

port

er

Expo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

J o b F l o w

O p e r a t o rIm

port

er

Expo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

4

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

まずはプロジェクト作成です。

5

6

7

h t tp : / /www . asakusa fw . com/down load/g rad l e -p l ug i n /t emp l a t e - ca t a l og -deve l op . t x t

上記U R L入力後「選択」ボタンを押下

8

9

空のプロジェクトが作成されました

10

11

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

次にデータモデルを定義します。 このヒシダマ印のアイコンを クリックしてください。

12

最初に商品マスタのモデルを定義します

13

プロパティを追加していくので、A D Dボタンを押下してください

14

まずは商品 I D

15

続いて同じように商品名

16

プロパティ追加後、p r e v i e wボタンを押下すると生成されるモデル定義を事前に確認することができます

17

F i n i s hボタンで

D M D L定義が生成されます

18

続いて売上明細の モデル定義を作ります

19

このように３つのプロパティを 登録します

20

D M D Lファイルに追記されました

21

J O I N結果用の モデル定義を作ります。

22

C O P Yボタン押下で J O I N元のプロパティをそのまま取り込むことができます

23

N e x tでこのダイアログに進むと、 結合キーを選択します。 まずは i t e m _ m a s t e rから

i t e m _ i dを選択してください。

24

i t e m _ i dが選択されました

i t e m _ i dを選択して、 e d i tボタンを押下してください

25

売上明細側の i t e m _ i dを 選択してください

26

結合キーの設定が完了です

27

D M D Lファイルに 結合モデル定義が追加されました

28

モデル定義の最後に、出力用の売上明細モデルを作ります

29

結合用モデルのプロパティを そのまま c o p yします

30

そこに、 f l gプロパティを追加します

31

D M D Lファイルに出力用モデルの 定義が追加されました

32

続いて、各モデル定義に属性を追加していきます。 このアイコンをクリックしてください。

33

全てのデータモデルを選択してください

（実際には j o i n e d _ s a l e sは選択不要ですが）

34

デフォルトの選択のまま進みます

35

付与するアノテーションを選択します

36

このボタンを押下すると、各属性のデフォルト値を設定できます。このボタンを押下し、出力される属性をそのまま利用します。

37

各モデルに属性情報が 追加されました

38

D M D L定義から、 実際のモデル用 J AVAソースを生成します

39

ソース生成されました。

40

41

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

各M o d e lの i m p o r t e r / e x p o r t e rを

作成します

42

まずは i t e m _ m a s t e rのI m p o r t e rを作成します。

43

どういう i m p o r t e rにするか選択します

44

デフォルト入力のまま 進みます

45

まずは i t e m _ m a s t e rのI m p o r t e rが作成されました

46

続いて売上明細用のI m p o r t e rを作成します

47

どういう i m p o r t e rにするか選択します

48

デフォルト入力のまま 進みます

49

s a l e s _ d e t a i lの I m p o r t e rが 作成されました

50

最後に出力明細用のE x p o r t e rを作成します

51

e x p o r t e rの種類を 選択します

52

デフォルト入力のまま 進みます

53

o u t p u t _ s a l e sのE x p o r t e rが 作成されました

54

55

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

続いて J O B F L O Wを 作って行きます

56

57

58

インポーターを選択して…

このあたりをクリックしてください

59

このアイコンをダブルクリックしてください

60

既存クラスから 選択できます

既存データモデルから選択できます

61

同じようにインポーターアイコンを 配置して、 s a l e s _ d e t a i lを登録します

62

I m p o r t e rの配置が完了しました

このアイコンを ダブルクリックしてください

63

i nの行を選択して…

e d i tを押下してください

64

i t e m _ m a s t e rからのインプットであることを定義します

65

a d dを押下します

66

s a l e s _ d e t a i lからのインプットであることを定義します

67

68

o u tの行を選択して…

e d i tを押下してください

69

o u t p u t _ s a l e sへのアウトプットであることを定義します

70

i n / o u tの登録が完了しました

71

i n / o u tの登録結果が ３つのアイコンに反映されました

72

エクスポーターを選択して…

このあたりをクリックしてください

73

エクスポーターアイコンを ダブルクリックして、

o u t p u t _ s a l e sを登録します

74

i n / o u tの配置が一通り完了しました

75

C o n n e c t i o nを選択して…

各アイコンを結びつけます

76

77

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

マスタ結合演算子を選択して…

M a s t e r J o i nのアイコンを配置します

78

C o n n e c t i o nを選択して…

i nとM a s t e r J o i nを結びつけます

79

停止演算子とC o n n e c t i o nで…

M a s t e r J o i nでマッチしなかった明細を無視するという登録をします

80

M a s t e r J o i nアイコンを ダブルクリックします

81

M a s t e r J o i n処理を割り当てるO p e r a t o rクラスとメソッドを登録します

82

拡張演算子を選択して…

この辺りに配置します

83

C o n n e c t i o nを選択して…

j o i n結果をe x t e n dに渡す 登録をします

84

85

更新演算子を選択して…

この辺りに配置します 配置後、ダブルクリックしてください

86

U p d a t e処理を割り当てるO p e r a t o rクラスとメソッドを登録します

87

C o n n e c t i o nを選択して…

e x t e n d結果をU p d a t eに渡すところと、U p d a t e結果を出力につなげる登録をします

88

M a s t e r J o i nの出口を ダブルクリックしてください

89

出力の型を定義します

90

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

91

M a s t e r J o i nアイコンを 右クリックして

G e n e r a t e D S Lを実行します

92

O p e r a t o rクラスが 生成されました

93

U p d a t eアイコンを 右クリックして

G e n e r a t e D S Lを実行します

94

O p e r a t o rクラスに メソッドが追加されました

95

処理を実装します

96

J o b F l o wアイコンを 右クリックして

G e n e r a t e D S Lを実行します

97

J o b F l o wクラスが 生成されました

98

H D F S

A s a k u s a A p p l i c a t i o n

B a t c h

J o b F l o w

O p e r a t o r

演算子

Impo

rter

Expo

rter

M o d e l

99

B a t c hの作成に入ります

100

101

102

ジョブフローを選択して…

この辺りに配置します

103

ダブルクリックします

104

先ほど生成した J o b F l o wを登録します

105

106

B a t c hのソース生成します

107

ソース生成されました

108

J o b F l o wのテストに入ります

109

M o d e l定義を基に エクセルが生成されます

110

各ファイルの i n p u tシート、 o u t p u tシートにテストデータを登録します

111

o u t p u tシートを登録したファイルは r u l eシートも登録します

112

s r c / t e s t / r e s o u r c e s 配下に移します

113

テストクラスを実装します

114

U n i tテストとして実装します

• cp asakusa-develop/workspace/DemoSample/build/DemoSample-batchapps.jar $ASAKUSA_HOME/batchapps/ 生成されたビルドファイルをコピー

• cd $ASAKUSA_HOME/batchapps/

• ll ~/target/testing/directio/sample/in/ 入力ファイルを確認

• $ASAKUSA_HOME/yaess/bin/yaess-batch.sh DemoBatch バッチを実行

115