Flex 빌더 설치하기
1. adobe 사이트로부터 Eclipse용 Flex Builder 를 내려받는다.

2. 내려받은 실행파일을 실행한다.

3. 언어를 선택한다.

4. [Next] 클릭

5. 라이센스에 동의한 후 [Next] 클릭.

6. Flex Builder 가 설치될 경로를 지정한다.

7. 이클립스가 존재하는 위치를 지정한다.

8. 플레시 플레이어 설치 여부를 지정한다. flex builder 3 는 9버젼대의 플래시를 만들어내지만, 현재 flash player 는 10버젼까지 나와있다.

9. 설치 할 정보에 대해서 보여준다. [Next] 클릭.

10. 인스톨이 진행된다.


11. 설치가 완료되었다.

플렉스로 작업하기
1. 이클립스 메뉴의 'Window -> Open Perspective -> Other' 클릭



2. Flex Development 선택


3. 이제 만들어진 플렉스 프로젝트를 가져오겠다. 'File -> Import' 클릭


4. 가져올 플렉스 프로젝트 경로를 설정한다.


5. 플렉스는 실행할 수 있는(즉, 메인의 의미를 가진) 페이지(?)는 녹색 화살표가 나타난다. 여기선 uis.mxml 이 실행 파일이다. 마우스 우측 버튼을 눌러 'Run As -> Flex Application' 을 클릭한다.


실행하면 파일이 bin-debug 안에 빌드된다. html 파일을 열면 swf 적용 태그까지 적용되어 바로 볼 수 있다.


이상 가장 기본적인 설정 및 구동 방법이었다. 사실, 이클립스를 아는 사람은 이거 읽을 가치를 못 느낄거다. ㅡㅡ;
그래도 새로운 것을 하는 걸 벌벌 두려워하는 사람들을 위하여 한번 작성해보았다.

java doc 생성시 일관되지 않은 방법으로 주석을 달아 의미없이 만들어지는 경우가 있다.
간단한 가이드를 작성해보았다.

 Java Doc 작성법


작성자 : 편현장(slothink@gmail.com)

작성일 : 2008.11.25


1.  Method 상단에 /** .. */ 주석을 추가하면, java doc 의 대상이된다.

2.  comment 는 반드시 /** 으로 시작해야한다. /* 은 java doc 의 대상이 아니다.

3.  메서드 설명은 html 형식으로 출력된다. 따라서 한줄 내리기 등은 <br /> 태그를 사용하는 등 html 구조에 맞춰 작성한다

4.  @param, @return, @throws 는 method 에서 필수속성이다(선언시)

기술 방법은 ex) @[type] [name] [description] 이다.
주의. Name 과 description 구분은 사이띄기로 구분한다. 만약, ‘-‘ 등의 값을 추가적으로 사용한다면, java doc 생성시에 - - 이 2개가 출력된다
(java doc 은 기본적으로 name 과 description 사이에 – 를 삽입한다)

5.  @throws 는 사용자가 처리해야할 예외이다. (예외는 에러가 아니다)
따라서 이 예외가 언제 발생하는지에 대해서 반드시 설명이 필요하다.

6.  @return 사용시 리턴 유형에 대해서는 기술할 필요가 없다. 왜냐하면, 이미 메서드 선언에 리턴 유형에 대해서 정의되어있기 때문이다.

@return Article 수정된 게시물 (x)
@return 수정된 게시물 (o)

7.  interface 가 존재한다면, 구현체에서는 주석을 달 필요가 없다.
interface 구현체는 interface 의 기능을 실제로 구현한 것이다.
다시말하자면, interface 에서 정의된 메서드의 의도대로 구현을 한 것이므로, interface 에서의 주석만으로 충분하다. 만약, 다르게 작성해야된다면, 올바르게 구현한것인지 다시 고려해봐야한다.
단, interface 에 정의되어 있지 않은 구현체의 method 는 주석을 필요로 한다.

8.  (non-JavaDoc) 는 eclipse 에서 주석 생성시 eclipse 안에 주석 템플릿이 존재하지 않을 경우에 자동 생성되는 코멘트다. 즉, java doc 생성시에는 의미없는 구문이다. 따라서 의미없는 주석은 삭제한다.

9.  주석 작성시, 다른 클래스를 참조할 경우에는 {@link } 를 사용한다.
이것은 java doc 에서 하이퍼링크를 생성한다. 화면에서는 클래스명만 나타난다.

사용 법 : {@link [class full name]}
ex) {@link com.vine.util.CommonWebFilter}

10.주석 작성시, code 를 기술할 경우엔, <pre> 태그를 사용한다.

<pre>
DetachedCrtieria crit = createCritera();
..
crit.addOrder(Order.asc(“name”));
</pre>

11.class 의 주석은 @author 태그와 설명을 필요로한다

/**
 * 시스템 환경 설정 저장소<br />
 * 시스템의 정의된 설정을 사용할 수 있다.
 * @author 편현장
public class SystemEnvirement {

}

잘못된 사용 예)

/**
 * 게시판을 생성한다.
 * 생성될 게시판코드가 이미 존재할 경우 예외를 발생시킨다.
 * @param code – 게시판 코드
*  @return Board – 생성된 게시판
 * @throws ExistCodeException
 */

/* (non-Javadoc)
 * @see com.comas.proguide.empower.EmpowerMenuService#getMenuAssignInfo()
 */

public Board create(String code) throws ExistCodeException {

교정 후)

/**
 * 게시판을 생성한다..<br />
 * 생성될 게시판 코드가 이미 존재할 경우 예외를 발생시킨다.
 * @param code 게시판 코드 // name 과 description 사이의 ‘-‘ 을 제거
* @return 생성된 게시판 // 반환 유형 기술(여기에선 Board) 삭제
 * @throws ExistCodeException 코드가 이미 존재하는 경우 // 주석 추가
 */
// 의미없는 eclipse 주석을 삭제하였다.(여기에서는 (non-JavaDoc).. )
public Board create(String code) throws ExistCodeException {

올바른 습관을 잘 들이자.

+ Recent posts