anarch's springlog

Tabla는 간단한 태그 기반의 템플릿 유틸리티입니다.  컨텐츠의 특정부분을 마크업을 이용하여 컨텐츠의 내용을 가공하기 위해서 작성했었습니다. :-)

간단한 예제

1. Tags tags = new Tags();

2. tags.addTag(new NamedTag() {

       public String execute(ParseTag pt,TagContext tc) {

         return "hello world!";

       }

       public String tagName() { return "t:hello"; } 

3. };
4.  
5. Parser p = new Parser(tags);
6. String result = p.parse("<t:hello />");
7.  
8. >> hello world!

클래스들

 1. Tag - 태그의 인터페이스.  태그의 행동을 정의합니다. 

 2. NamedTag - 태그(Tag)의 인터페이스 상속.  태그이름(tagName)을 등록할수 있습니다.  

 3. Tags - 태그들 

 4. TagBinding - 파싱된 컨텐츠(Parse)와 Tag을 바인딩(Binding)하는 책임이 있습니다. 

 5. TagContext - 외부 환경이나 태그 간의 문맥적으로 값을 전달할때 사용됩니다. 

 6. Parse - 파싱된 컨텐츠(Parse)

 7. ParseTag  - 파싱된 컨텐츠중 태그 정보 

 8. Parser - 파서 

 9. ParseFailureException - 파싱 실패 예외 상황 

 10. utils.ParseTagRemover - 태그 시그니처 제거자 유틸리티. 

태그 정의 하기

태그를 정의하는 건 매우 쉽습니다. Tag,NamedTag을 구현하면 됩니다. 

1. Tag t = new Tag() {
2.     public String execute(ParseTag pt,TagContext tc) {
3.        return pt.getContent();
4.     }
5. };
6. Tags tags = new Tags(); 
7. tags.addTag("t:*",t);
8. ...

위의 코드는 t:으로 시작하는 모든 태그에 반응하게 됩니다. 물론  ParseTag.getTagName()으로는 정확한 태그 이름을 얻을수 있습니다. 

파싱된 컨텐츠의 태그정보 - ParseTag

모든 태그는 ParseTag와 TagContext이라는 파라미터 객체를 얻게 됩니다. ParseTag은 Parser가 파싱한 컨텐츠중에 현재 태그에 해당하는 영역을 ParseTag에 담아서 전달하게 됩니다.  

1. class NewsDataTag implements NamedTag {
2.    public NewsDataTag(NewsDataService newsDataService) {
3.       this.newsDataService = newsDataService;
4.    }
5.    public String execute(ParseTag pt,TagContext tc) {
6.       String size = pt.getTagAttrMap("size");
7.       String category = pt.getTagAttrMap("category");
8.       List<NewsData> newsData = newsDataService.findBy(size,category);
9.       return newsData.toBuildHtml();
10.    }
11. }

태그의 글로벌 영역? - TagContext

태그와 태그(중첩된 태그 등등)나 태그를 실행중으로 값을 전달할때가 있습니다.

1. tags.add("t:container",new Tag() {
2.    public String execute(ParseTag pt,TagContext tc) {
3.       ...
4.       for(Item item : items) {
5.           tc.addLocalAttribute("itemTitle",item.getTitle());
6.           tc.addLocalAttribute("itemUrl",item.getUrl());
7.           result.append(pt.getContent());
8.           tc.clearLocalAttibutes();
9.       }
10.       return result.toString();
11.    } 
12. });
13.  
14. tags.add("t:itemTitle",new Tag() {
15.     public String execute(ParseTag pt,TagContext tc) {
16.        String itemTitle = (String) tc.getLocalAttribute("itemTitle");
17.        if(itemTitle != null) {
18.            return itemTitle;
19.        }
20.        return pt.getContent();
21.     }
22. });
23.  

1. items: a,b,c 
2. <t:containter ><t:itemTitle />,</t:container>   
3. >> a,b,c,

기타

뭐 그리 잘 만들었다거 그런건 아니지만. 그리고 만든지 몇달이 지나서 그닥 머리속에 남아 있는 것이 별루 없긴 하네요. 좀더 수정할것은 많은 듯 합니다만. :-)

tabla-0.0.2-sources.jar

tabla-0.0.2.jar