[STAN] Structure Analysis for Java > Tasks > Using the Structure Explorer

STAN - Structure Analysis for Java > Tasks

Using the Structure Explorer

Structure Explorer는 STAN의 주요 선택 도구이다. Structure Explorer는 인공물 관리 계층을 보여둔다. 인공물을 선택하면 그것이 현재 노드가 된다: 모든 다른 뷰들은 해당 노드에 대응되는 컨텐츠를 보여줌으로써 이를 반영한다.
explorer의 root node는 전체 project/application에 대응된다. root의 컨텍스트 메뉴는 Properties 아이템을 포함하는데 이는 application properties 다이얼로그를 열어준다(단축키는 ALT+ENTER).
만약 분석이 클래스를 제외하면, 이들은 root와 분리되어 "Filtered Classes"로 라벨링되어 보여진다.

Refresh 컨텍스트 메뉴 아이템을 사용하여(또는 explorer가 활성화된 상태에서 F5를 누른다) 분석을 재실행한다. 이는  밑에 포함된 리소스들이 디스크 상에서 변경되었다면 유용하다(클래스 파일들과 JAR들)

인공물들은 인공물 자체나 그것의 자식들중 하나가 특정 측정 기준으로 등급이 지정되는 경우 에러 마크를 보여준다. 경고 표시는 인공물이나 그것의 자식을 위한 최악의 등급이 주황색 범위에 빠지게 됨을 가리킨다. 결과적으로 에러나 경고가 없는 인공물들은 측정 기준을 위반하지 않고 있다는 것을 의미한다.

Excluding/Including Artifacts from the Structure Explorer

패키지 트리의 경우 평범한 패키지들과 클래스들은 Exclude 아이템 항목을 포함하는 컨텍스트 메뉴를 포함한다. Explorer로부터 인공물을 제외하는 것은 자동적으로 적절한 exclusion 패턴을 추가하고 분석을 재가동함으로써 어플리케이션 특성들을 변경할 것이다.

Note

Application properties를 열고 Filter tab으로 가서 현재 활성화된 패턴 리스트들을 손수 관리할 수 있다. 필터 패턴에 대한 더 많은 정보는 Specifying Class Filter Patterns를 참고해라.

필터링된 클래스들은 grayed-out icons으로 분리된 root 밑에 보여진다. 명확하게 제외된 패키지 트리들, 평범한 패키지들 그리고 클래스들은 In-out 마커로 장식되고 컨텍스트 메뉴의 Include로 다시 포한될 수 있다(부모가 제외되었을 때는 제외된다)

Warning

필터 패턴들은 어플리케이션 전체 영역이다. Thus, using the Exclude menu item while in Show Libraries mode may cause artifacts from other libraries be excluded as well (e.g. when excluding a package that extends over several libraries.

Linking the Structure Explorer with Views

synched Link with View button은 explorer와 뷰를 연결하는데 사용된다. 이 모드에서,
The Link with View button is used to link the explorer to views. In this mode,

• Composition View에서 artifact를 탐색하는 것은 그 artifact를 현재 노드로 만들 것이다.
• Couplings View에서 artifact를 탐색하는 것은 그 artifact를 현재 노드로 만들 것이다.

Structure Treemap

Structure Explorer가 활성화되었을 때(포커스를 가지고있는) OverView는 트리맵으로써 현재 노드 현재 노드에 뿌리를 둔 서브트리를 형상화해준다. 트리맵 셀을 더블 클릭하면 explorer에서 대응되는 노드가 선택되고 그것이 새로운 현재 노드가 된다.

• 트리맵 셀의 색깔은 artifact 타입에 대응된다.(예를 들어, 클래스는 녹색, 인터페이스는 분홍색이다)
• 트리맵 셀의 사이즈는 artifact에 포함된 코드의 양을 가리킨다.

[STAN] Structure Analysis for Java > Tasks > Analyzing Code > Setting Analysis Preferences

Setting Analysis Preferences

Analysis Preference 페이지는 Level of Detail과 Exclusion Patterns을 위한 기본값을 명세하게 해준다.(Specifying Class Filter Patterns을 보아라).
새로운 analysis를 설정할 때, preferences를 초기값으로 취하게 된다.

[STAN] STAN - Structure Analysis for Java > Tasks > Analyzing Code > Specifying Class Filter Patterns

Specifying Class Filter Patterns

Class filters는 분석을 형성하는 라이브러리들로부터 클래스의 부분집합들을 조정게 해준다. 두가지 종류의 필터가 있다.

• Inclusions 특정 클래스들이 분석되게 하는 규칙을 명세하는 Ant-style 패턴들의 부분집합으로 주어질 수 있다. 만약 inclusions이 정의되지 않았다면 기본 패턴이 적용된
• Exclusions 틀정 클래스들이 무시되도록 하는 규칙을 명세하는 Ant-style 패턴의 집합이 주어질 것이다.

만약 클래스가 적어도 하나의 inclusion 패턴에 매칭되고 어떤 exclusion 패턴에 매칭되지 않는다면 클래스는 분석의 부분이 된다.
패턴은 패스 구분자로 점'.' 대신에 슬래시'/'를 사용한다. 다음의 와일드카드들이 사용가능하다:

1. ? 는 하나의 캐릭터와 매칭된다(드물게 사용된다)
2. * 는 '/'를 포함하지 않는 연속된 캐릭터와 매칭된다.
3. ** 는 어떤 캐릭터들과도 매칭된다.

패턴을 쉽게 사용하기 위해서는 몇몇 standard pattern 타입들과 일치시키자:

1. "/*"으로 끝나고 어떤 와일드카드를 포함하지 않는다면 하나의 패키지와 매칭된다. 예를 들어 com/foo/bar/* 는 com.foo.bar 패키지의 모든 클래스들과 매칭된다.
2. "/**"으로 끝나고 어떤 와일드카드를 포함하지 않는다면 패키지 트리와 매칭된다. 예를 들어, com/foo/bar/**는 com.foo.bar 패키지 트리로부터의 모든 클래스들과 매칭된다.  com.foo.bar.baz 등등.
3. 어떤 와일드 카드도 없는 패턴은 하나의 클래스와 매칭된다(inner class를 포함하여). 예를 들어 com/foo/bar/Baz는 com.foo.bar.Baz와 com.foo.bar.Baz$1과 같은 중첩 클래스와 매칭된다.

위의 표준 타입의 패턴들은 만약 Structure Explorer로부터 인공적으로 제외되지 않는다면 자동으로 분석에 적용된다. 우리는 complex patters으로서 표준 타입과 매칭되지 않는 패턴들을 참조한다. complex patterns의 예는 다음과 같다.
Patterns of the above standard types are automatically applied to the analysis if you exclude artifacts from the Structure Explorer. We refer to patterns that do not match the standard types as complex patterns. Examples for complex patterns are:

• **/test/** 는 "test" 세그먼트를 포함하는 패키지명의 모든 클래스들과 매칭된다. 
• **/Test* 는 "Test"로 시작하는 모든 package 내의  클래스들과 매칭된다.

새로운 분석을 생성할 때, 기본 inclusion 패턴은 라이브러리와 기본 exclusion 패턴으로부터 모든 클래스들과 매칭한다.(이 패턴은 inclusion pattern 리스트에는 표시되지 않는다)

[STAN] Structure Analysis for Java > Tasks > Analyzing Code > Selecting Libraries

Selecting Libraries

Library Page는 분석의 코드 베이스를 형성하는 라이브러리의 리스트를 유지한다.

• JAR 파일들을 추가하기 위해 Add JARs... 버튼을 누른다.
• 클래스 폴더를 추가하기 위해 Add Foldr... 버튼을 누른다.

Up과 Down버튼은 라이브러리 아이템들의 순서를 정렬하기 위해 사용할 수 잇다. Structure Explorer은 Show Libraries 모드에서 이 순서대로 라이브러리들을 보여준다. 선택된 아이템을 제거하려면 Remove button을 사용한다.

[STAN] Structure Analysis for Java > Tasks > Analyzing Code > Choosing the Level of Detail

Choosing the Level of Detail

Level of Detail은 분석의 상세 정도를 결정한다.

• Class - 분석의 상세 레벨은 클래스 계층으로 제한될 것이다. 필드나 메소드의 어떤 정보도 수집되지 않는다. 이 모드는 매우 큰 코드 베이스이거나 클래스의 상세 정보에는 관심이 없는 경우 시간과 메모리 사용을 감소시키기 위해 사용된다.
  
• Member - 분석은 전체 레벨의 상세정보에 대해 수행된다. 필드와 메소드 정보가 수집된다. 메소드 매트릭스와 멤버 의존성 그래픽을 사용할 수 잇다.
  

새로운 분석을 생성할 때 상세정보의 기본 레벨은 Analysis Preferences로부터 취하게 된다.

[STAN]Structure Analysis for Java > Tasks > Analyzing Code

Analyzing Code

STAN의 RCP(stand-alone) 변종은 이른바 Projects라 불리는 것을 사용한다. Project settings은 workspace에 저장되어 수정될 수 있고 언저든지 실행할 수 있다.

Running an Analysis

Projects View는 workspace에 있는 모든 STAN 프로젝트들을 보여준다. 더블 클릭을 통해 프로젝트를 실행시키거나 컨텍스트 메뉴의 Analyze를 선택해서 실행시킬 수 있다.

Creating a new project

새로운 프로젝트를 열기 위해 메뉴바의 File > New 를 선택하거나 ALT+SHIFT+N을 선택한다. 다른 방법 : CTRL+N을 누르고 리스트에서 위저드를 선택한다.
프로젝트의 이름을 입력하고 아래에 설명하는데로 프로젝트 설정으로 통과하기 위해 다음을 누룬다.

Configuring an Analysis

Project Configuration 다이얼로그는 다음의 페이지를 갖고 있다.

1. General - 이 페이지에서 Level of Detail을 선택할 수 있다.
2. Libraries - 이 페이지는 코드베이스를 형성하는 라이브러리의 리스트를 유지한다.
3. Filter - 이 페이지는 당신의 Class Filter Patterns을 설정할 수 있게 해준다.

다 설정했으면, Finish를 누른다.
존재하는 프로젝트의 설정을 변경하기 위해서는 Projects View의 컨텍스트 메뉴에서 Properties를 선택한다. 현재 분석중인 프로젝트를 위해서는 Structure Explorer에 있는 root의 컨텍스트 메뉴로부터 선택하면 된다.

Chapter8. HTTP 서버

학습 목표

1. HTTP 모듈을 이용해서 서버를 작성할 수 있습니다.
2. HTTP 요청을 분석하는 코드를 작성할 수 있습니다.
3. HTTP 응답 메시지를 작성하는 코드를 작성할 수 있습니다.
4. 정적 파일 요청과 서비스 제공하는 서버를 작성할 수 있습니다.

1. HTTP 서버

◎ HTTP 서버 구동 코드

var http = require('http');

var server = http.createServer(function(req, res) {

    res.end('Hello World');

}).listen(3000);

2. HTTP 요청

◎ HTTP 요청

• 클라이언트 요청 분석
• request 이벤트 리스너의 파라미터
• req : IncomingMessage
  var server = http.createServer(function(req, res) {} )

▷ 클라이언트 요청 분석

▷ IncomingMessage

• message.url : 요청 url, 경로와 쿼리 문자열
• message.method : 요청 메소드
• message.headers : 요청 메소드의 헤더
• message(streamable) : 요청 메시지 바디

▷ 요청 URL 경로와 쿼리 문자열 분석

▷ URL 분석하기 : URL 모듈

var url = require('url');

url.parse(req.url, true);

▷ 요청 메시지 헤더 분석

▷ 헤더 정보 : request.header

var headers = request.headers;

headers.host;

headers.content-type;

headers.user-agent;

. . .

▷ 요청 메시지 바디 분석

• IncomingMessage의 data 이벤트 사용
• POST 요청을 다루는 장에서 다룬다.

◎ HTTP 요청 출력

▷ 요청 내용 콘솔에 출력하기

var server = http.createServer(function(req, res) {
    console.log('HTTP Method : ' + req.method);
    console.log('HTTP URL : ' + req.url);
    console.log('== HEADERS ==');
    console.log(req.headers);

    res.end('Hello Node.js');
});

3. HTTP 응답

◎ 응답 메시지

• 응답 메시지 : http.ServerResponse
• 상태 코드와 상태 메시지
• 응답 메시지 헤더
• 응답 메시지 바디

▷ 메시지 상태

response.statusCode

response.statusMessage

▷ 메시지 헤더

response.writeHead(statusCode[, statusMessage][, headers])

response.removeHeader(name)

response.getHeader(name)

response.setHeader(name, value)

▷ 메시지 바디

response.end([data][, endcoding][, callback])

response.write(chunk[, encoding][, callback])

▷ HTTP 상태 코드와 메시지
// 200 OK
response.statusCode = 200;
response.statusMessage = 'OK';

// 404 Error
response.statusCode = 404;
response.statusMessage = 'Not found';

▷ 응답 메시지 헤더

▷ 응답 코드, 메시지 헤더 작성 함수 : writeHead
res.writeHead(200, {'Content-Length': body.length,
                          'Content-Type': 'text/plain'});

▷ 헤더 작성하기 : setHeader
res.setHeader("Content-Type", "text/html");
res.setHeader("Content-Length", body.length);

▷ 응답 메시지 바디
▷ 응답 메시지 종료
response.write(chunk[, endcoding][, callback])
response.end()

▷ 응답 메시지 작성 시 주의

▷ 응답 메시지 종료 - 클라이언트 대기 - timeout
http.createServer(function(req, res) {
    res.write('Hello Node.js');
    res.end(); // 응답 메시지를 완료시켜주어야 한다.
});

▷ 메시지 헤더는 메시지 바디 작성 전에
res.write('Hello World');
// 바디를 작성한 이후에 헤더를 작성하면 에러가 발생한다.
res.setHeader('Conent-Type', 'text/plain');

4. HTTP 서버 작성

◎ 정적 파일 요청

▷ 정적인 컨텐츠(이미지, html, 음악 등) 요청

• 미리 작성된 파일로 응답

▷ 요청 예

• http://myServer.com/image/cat.jpg
• http://myservice.net/music/sing.mp3

▷ 요청 경로

• req.url

▷ 요청 경로 분석

• path 모듈

▷ 정적 파일 요청 : 응답

• 정적 파일 찾기
• 파일 로딩, 응답

▷ fs 모듈

• fs.readFile(FILEPATH, CALLBACK);

▷ 응답 메시지에 파일 내용 쓰기

• res.write();
• res.end();

▷ 정적 파일 요청에 대한 응답

fs.access(path, fs.F_OK, function(exist) {

    fs.readFile(path, function(err, data) {

        res.end(data);

    });

});

◎ 정적 파일 요청

• 정적 파일 요청에 대한 응답
• 정적 파일 체크
• 상태 코드
• 컨텐츠 타입

▷ 파일이 없으면?

▷ 404 에러 처리 코드

fs.access(path, fs.R_OK, function(err) {

    // 접근 불가능 시 404 에러

    if( err ) {

        res.statusCode = 404;

        res.end('Not Found');

        return;

    }

}

▷ 정적 파일 응답

fs.access(path, fs.F_OK, function(err) {

    if( err ) {

        res.statusCode = 404;

        res.end('Not found');

        return;

    }

    fs.readFile(path, function(err, data) {

        res.statusCode = 200;

        res.setHeader('Content-type', 'image/jpg');    // 이미지라면

        res.end(data);

    });

});

▷ 스트림 파이프

• 입력 스트림 : fs.createReadStream()
• 출력 스트림 : res
  fs.createReadStream(path).pipe(res);

▷ 파미콘 : 웹 사이트의 아이콘 이미지

▷ 파비콘 요청

• GET /favicon.ico

▷ 파비콘 응답 코드

if( request.url == '/favicon.ico' ) {

    // 파비콘 처리

    return;

}

▷ 컨텐츠 타입

var server = http.createServer(function(req, res) {

    if(req.url == '/favicon.ico') {}

    else if(req.url == '/image.png' ) {

        res.writeHeader(200, {'Content-Type':'image/png'});

        fs.read...

    }

    else if(req.url == '/music.mp3') {

        res.writeHeader(200, {'Content-Type':'audio/mp3'});

        fs.createReadStrea...

    }

    else if(req.url == '/movie.mp4') {

        res.writeHead(200, {'Content-Type':'video/mp4'});

        fs.createReadStream...

    }

});

◎ 정적 파일 서비스

▷ 요청 URL의 경로를 실제 파일 경로 매핑

• myServier.com/resource/image.png -> ./resources/image.png
• myServier.com/resource/audio.mp3 -> ./resources/audio.mp3

▷ 요청 url에서 경로 생성

URL로부터 파일의 패스 정보를 가져와서 바로 파일에 대한 경로를 만들어 줄 수 있다.

파일을 찾고 파일에 대한 읽기위한 경로를 만드는 과정이 단순해짐.

var pathUtil = require('path');

var path= __dirname + pathUtil.sep + 'resources' + req.url;

◎ 웹 페이지 서비스

▷ 요청

• 인덱스 요청
• 파비콘 요청
• JS와 css요청
• 이미지 요청 : <img>

▷ 서비스 용 html

<html>

<link rel="stylesheet" type="text/css" href='public/style.css'>

<body>

    <h1>Hello Kitty</h1>

    <img src='image/cat.jpg'>

</body>

</html> 

html요청

css 요청

image 요청

파비콘 요청 에 대한 응답 처리를 모두 해주저야 한다.

▷ 서버 코드

var server = http.createServer(function(req, res) {

    if(req.url == '/favicon.ico') {

        // 파비콘 응답

    }

    else if(req.url == '/') {

        // 기본 페이지 : index.html

        fs.createReadStream('./public/index.html').pipe(res);

    }

    else {

        var path = __dirname + req.url;

    }

})

◎ 서비스

▷ 서비스

▷ URL 쿼리 문자열 : 합계 구하기

http://127.0.0.1:3000/count?start=1&end=10

▷ 서버 코드

// URL 분석 : 쿼리 문자열

var parsed = url.parse(request.url, true);

var query = parsed.query;

// start와 end

var start = parseInt(query.start);

var end = parseInt(query.end);

if(입력값 오류) {

    response.statusCode = 404;

    response.end('Wrong Parameter');

}

else {

    // 합계 구하기

    response.statusCode = 200;

    response.end('Result : ' + result);

}

학습 정리

◎ 지금까지 'HTTP 서버'에 대해 살펴보았습니다.

• HTTP 요청
  클라이언트의 HTTP 요청을 분석했습니다.
• HTTP 응답
  클라이언트에게 HTTP 응답 메시지를 작성하고 전송하는 방법을 알아봤습니다.
• HTTP 서버
  다양한 형태의 HTTP 서버 작성 방법을 알아봤습니다.