2020년 8월 5일 수요일

REST, REST API, RESTFUL API

[REST (Representational State Transfer)]

    자원을 URI로 표시하고 해당 자원의 상태를 주고 받는 것

    REST하지 못한 API는 ?
        CRUD 기능을 전부 POST METHOD로만 처리하는 API
        URI에 자원과 id외 정보가 들어가는 경우

[REST 구성 요소]

    자원(Resource): URI
    행위(Verb): HTTP METHOD
    표현(Representations)

    즉, Rest는 URI를 통해 자원을 표시하고, 
    HTTP METHO를 이용하여 해당 자원의 행위를 정해주며
    그 결과를 받는 것

[REST 특징]

    Uniform Interface (유니폼 인터페이스)
        HTTP 표준만 따른다면 어떤 언어 혹은 어떤 플랫폼에서 사용하여도 사용이 가능한 인터페이스 스타일
    
    Stateless (상태 정보 유지 안함)
        서버는 각각의 요청을 완전히 다른 것으로 인식하고 처리
        이전 요청이 다음 요청 처리에 연관이 되면 안된다

    Cacheable (캐시 가능)
        웹 표준을 그대로 사용하기 때문에 HTTP가 가진 캐싱 기능 적용이 가능

    Self-descriptiveness (자체 표현 구조)
        Rest API 메시지만 보고도 쉽게 이해할 수 있는 자체 표현 구조

    Client-Server
        Rest 서버는 API 제공
        클라이언트는 사용자 인증에 관련된 일들을 직접 관리
        자원이 있는 쪽을 Server라고 하고 자원을 요청하는 쪽이 Client가 됨
        서로간의 의존성이 줄어들기 때문에 역할이 확실하게 구분되어 개발해야할 내용들이 명확해짐

    Layerd System (계층화)
        클라이언트는 Rest API 서버만 호출
        Rest 서버는 다중 계층으로 구성될수 있음
        로드 밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 둘 수 있음

[REST API]
    Rest 기반의 규칙들을 지켜서 설계된 API를 Rest API 혹은 Restful API라고 함

[REST API 설계 규칙]
    URI는 정보의 자원을 표현
    자원의 이름은 명사로 사용
    URI는 자원을 표현하는데 중점을 둠, 행위에 대한 표현이 들어가면 안됨
    
    GET /users/321
        자원에 대한 행위는 HTTP METHOD로 표현 (GET, POST, PUT DELETE)
        URI에 자원의 행위에 대한 표현이 들어가지 않는 대신 HTTP METHOD를 통해 대신함

        GET /users/321 
        321 ID를 가진 유저 정보를 가져오기

        DELETE /users/321 
        321 ID를 가진 유저 정보를 삭제하기

        POST /users 
        유저를 생성하기


    슬래시 (/)는 계층 관계를 나타내는데 사용
        http://restapi.test.com/users/rooms
        http://restapi.test.com/users/board
    
    URI 마지막은 슬래시(/)를 사용하면 안된다.
        http://restapi.test.com/users/rooms/ [X]
        http://restapi.test.com/users/rooms  [O]

    하이픈 (-)은 URI의 가독성을 높이는데 사용
    언더바(_) 혹은 밑줄은 URI에 사용하지 않음

    URI는 경로에는 소문자가 적합
    대소문자에 따라 각자 다른 리소스로 인식하기 때문

    파일 확장자는 URI에 포함하지 않는다
        Accept header를 사용

    리소스 간의 관계를 표현하는 방법
        GET : /users/{userid}/devices

[RESTFUL API]
    REST를 REST답게 쓰기 위한 방법이지만 누군가가 공식적으로 발표한 것이 아니고
    그저 개발자들이 비공식적으로 의견을 제시한 것이라 명확한 정의는 없다고 함
    하지만 RESTFUL의 목적은 이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것

    CRUD                 HTTP METHOD    URI
    user들을 표시       GET             /users
    user 하나만 표시   GET             /users/:id
    user를 생성      POST             /users
    user를 수정      PUT             /users/:id
    user를 삭제      DELETE             /users/:id
    
    Restful 하지 못한 경우
        CRUD 기능을 전부 POST METHOD로만 처리하는 API
        URI에 자원과 id외 정보가 들어가는 경우
    
        PUT /users/update-nickname [X]
        PUT /users/:id/nickname [O]

MSA (Micro Service Architecture) 기본구성, 구조설계

MSA (Micro Service Architecture) 기본구성, 구조설계

출처 : Medium https://medium.com/@yesesyo

[요약]
    - 독립적 배포 가능한 
    - 스스로 돌아 갈 수 있는 작은 서비스
    - 물리적으로 분리된 서비스이지만, 논리적으로는 하나의 어플리케이션처럼 동작
    - 서비스끼리 분리되어 있기 때문에 성능, 트랜젝션 관리, DB무결성 이슈는 가장 주의해야할 요소

[장점]
    개별 배포 및 무중단 배포 가능 (독립성)
    개별 배포가 가능하다는것은 요구사항을 신속하게 반영하여 빠르게 배포할수있다는 효과를 가져옴
    특정 서비스에 대한 확장성이 용이함
    장애가 전체 서비스로 확장될 가능성이 적음
    부분적 장애에 대한 격리가 수월함
    신기술의 적용 유연
    서비스를 여러가지 언어로 개발/운영 가능

[단점]
    전체 서비스가 커짐에 따라 그 복잡도가 기하급수적으로 늘어날 수 있음
    서비스 간 호출 시 API를 사용하기 때문에, 통신 비용이나, Latency가 그만큼 늘어남
    서비스가 분리되어 있기 때문에 테스트와 트랜잭션의 복잡도가 증가하고, 많은 자원을 필요로 함
    데이터가 여러 서비스에 걸쳐 분산되기 때문에 한번에 조회하기 어려움
    데이터의 정합성 또한 관리하기 어려움

[MSA 구축 필수요소]
    1) Service Discovery
        각 서비스들의 네트워크 위치 정보와 가용 상태를 관리할 수 있는 서비스 레지스트리(Service Registry)를 둠
            클라이언트가 서비스 레지스트리에게 가용 상태에 있는 서비스의 네트워크 위치 정보를 질의
            서버사이드 디스커버리 / 클라이언트사이드 디스커버리 로 구현방식이 나눠짐
                클라이언트사이드 디스커버리
                    클라이언트가 직접 서비스 레지스트리에 질의
                    클라이언트의 서비스 레지스트리 접근 의존성 발생
                    클라이언트(사용자)/서버 관계가 아닌 서비스/서비스 관계일때에는 고려해볼수 있는 방법론
                서버사이드 디스커버리
                    클라이언트와 서버 레지스트리 사이에 로드 밸런서(Load Balancer)를 둠
                    로드 밸런서가 서비스 레지스트리에 질의
                    일반적인 클라이언트(사용자)/서버 관계에서는 이 방식을 사용

        Netflix Eureka 를 사용하여 구현
            Eureka는 Netflix OSS(Netflix Open Source Software)에 포함된 컴포넌트들 중 하나
            Eureka 서버(서비스 레지스트리)와 Eureka 클라이언트로 구성
            Spring Cloud Netflix에서 제공하는 패턴에도 포함되어있음
            Eureka & Zuul은 Ribbon(리본:로드밸런서)을 내장하고 있다
                동일한 서비스가 다수의 인스턴스로 운영될 경우, 라운드 로빈을 기반으로 서비스 인스턴스를 호출

                * 라운드로빈 
                    서버에 들어온 요청을 순서대로 돌아가며 배정하는 방식
                    클라이언트의 요청을 순서대로 분배하기 때문에 여러 대의 서버가 동일한 스펙을 갖고 있고
                    서버와의 연결(세션)이 오래 지속되지 않는 경우에 활용하기 적합
    
    2) API Gateway
        서비스에 해당하는 각 API 서버의 엔드 포인트 단일화 -> 시스템 복잡도를 숨기는 효과를 가져옴
        클라이언트와 서비스 사이에 위치
        클라이언트의 요청을 처리할 적합한 서비스로 라우팅
        API 게이트웨이는 클라이언트의 요청을 처리해줄 서비스 주소를 서비스 레지스트리에 질의
        
        Netflix Zuul 를 사용하여 구현
            Zuul은 Netflix OSS(Netflix Open Source Software)에 포함된 컴포넌트들 중 하나
            Zuul은 단순한 라우팅 이외에도 요청과 응답을 동적으로 가로채 HTTP 메시지 필터링 기능 제공
            필터기능을 사용하여 접속IP차단도 가능
            Eureka & Zuul은 Ribbon(리본:로드밸런서)을 내장하고 있다
                동일한 서비스가 다수의 인스턴스로 운영될 경우, 라운드 로빈을 기반으로 서비스 인스턴스를 호출

    3) Circuit-breaker
        마이크로서비스에 일시적 오류 발생시 조기 차단, 장애 확대를 막고 서비스를 보호
        Hystrix (휴스트릭스)를 사용하여 구현
    
    4) Message Queue
        서비스들 간의 통신은 비동기로 구현, 서비스들 간의 의존성이 발생하지 않도록 함

        Apache Kafka
            대용량 및 실시간 처리 특화
            단순한 TCP 기반의 프로토콜을 사용함, 오버헤드 낮음
            메모리가 아닌 파일시스템에 메세지 저장
            OS에서 처리하는 페이지 캐시를 이용, 속도 빠름
            consumer가 pull 방식으로 메세지를 받으며, batch 처리가 가능합니다.

    5) API성능 모니터링   
        Zipkin (집킨)을 사용하여 구현

    5) ETC
        File Beat (로그파일 전송) : 엘라스틱서치 구현시 파일전송에 사용

2020년 3월 13일 금요일

서버간 ssh-key를 사용한 로그인 환경 구축하기

[개요]
A서버에서 B서버에 ssh 또는 scp 명령을 사용한 원격지 접속을 할 때
실 패스워드를 사용하지 않고
ssh-key 를 사용한 공개키 로그인 인증을 통해 접속하도록 함

[환경]
출발지 : A서버
계정 : auser
계정홈 : /part1/auser

도착지 : B서버
계정 : buser
계정홈 : /part1/buser

[절차]

1. 출발서버(A서버) ssk-key 생성
  $ ssh-keygen -t rsa

2. 권한 체크

700 : drwx------ : /part1/auser/.ssh/
600 : rw------- : /part1/auser/.ssh/id_rsa
600 : rw------- : /part1/auser/.ssh/id_rsa.pub

만약 위와 같은 권한으로 되어있지 않을경우 권한 변경 필요
(왜? ssh-key 인증에 필요한 환경에 소유자 외에 쓰기권한이 있을경우 처리불가)
chmod 700 /part/auser/.ssh
chmod 600 /part/auser/.ssh/id_rsa
chmod 600 /part/auser/.ssh/id_rsa.pub

3. 도착서버(B서버) authorized_keys에 출발서버 공개키 등록
A서버 : cat /part1/auser/.ssh/id_rsa.pub
B서버 :
 - 열고 : vi /part1/buser/.ssh/authorized_keys
 - A서버에서 확인한 키값을 맨 아랫줄에 붙여넣기
 - 좀더 스마트하게 작업할수도있겠지만.. 지금 바빠서 다른 붙여넣기 방법은 다른 블로그를 확인!!!
 - .ssh 폴더랑 authorized_keys 파일이 없으면 ? mkdir 이랑 touch명령으로 만들어도 됨
 - B서버도 마찬가지로 .ssh 디렉토리랑 authorized_keys는 700 으로 권한 변경 해주자
 - 또한! buser 계정에 홈에 해당하는 /part1/buser/ 디렉토리도 소유자 외에 쓰기권한이 없어야 한다 (700, 755, 750 등등.. 소유자를 제외한 영역에 w 권한만 없으면 오케이)

이제 설정은 완료됐고
테스트를 해보면 패스워드를 입력하라는 문구는 발생하지 않을것이다

끝.
         




2019년 10월 7일 월요일

flutter showDatePicker locale 설정을 통해 한국어로 표현되게 하는방법

제목 그대로..
showDatePicker 를 사용하면
아래와같은 형태로 사용할수가 있는데

Future<Null> _selectDate(BuildContext context) async {
  final DateTime picked = await showDatePicker(
      context: context,      
      initialDate: selectedDate,      
      firstDate: DateTime(2015, 8),      
      lastDate: DateTime(2101),      
      initialDatePickerMode: DatePickerMode.year,      
      //locale : const Locale('kr')  
    );  
    if (picked != null && picked != selectedDate)
      setState(() {
                  selectedDate = picked;      
                  debugPrint("_selectDate");      
                  debugPrint(selectedDate.toString());    
     });}

위 소스처럼 locale을 직접 할당하면 datePicker 로딩부터 실패한다

그래서 해결방법을 찾아본 결과
아래와같이 MyApp에서 locale설정을 해주면
이곳에 설정한 locale옵션을 따라서 datepicker의 언어설정이 바뀌게된다

class MyApp extends StatelessWidget {
  @override  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',      
      localizationsDelegates: [
                           GlobalMaterialLocalizations.delegate,        
                           GlobalWidgetsLocalizations.delegate, 
                           // if it's a RTL language      
                           ],      
      supportedLocales: [
        const Locale('ko', 'KR'), 
        // include country code too      
      ],      
      home: RootPage(),    
     );  
   }
}

뽜이팅 !!



2019년 6월 11일 화요일

java version 특징 (jdk, java, version)


1996
JDK 1.0 / Java 1
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
1997
JDK 1.1 / Java 1
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
1998
JDK 1.2 / Java 2
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
2000
JDK 1.3 / J2SE 1.3
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
2002
JDK 1.4 / J2SE 1.4 / JRE 1.4
java version 1.4.0
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
2004
JDK 5 / Java SE 5 / JRE 5
java version 1.5.0
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
2006
JDK 6 / Java SE 6 / JRE 6
java version 1.6.0
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

2011
JDK 7 / Java SE 7 / JRE 7
java version 1.7.0

- 다이아몬드 연산자 적용
- Generics 사용성 개선
    JDK 7 이전
    case 1 : List<Integer> list = new LinkedList();         
            Integer외에 다른 타입을 대입해도 컴파일 오류가 나지 않지만, 런타임 오류 발생
    case 2 : List<Integer> list = new LinkedList<Integer>();
            권장 문법
    JDK 7부터는 위 case 1 에 해당하는 문법 사용불가, 다이아몬드 연산자를 반영하여 아래와같이 사용
        List<Integer> list = new LinkedList<>();

- Switch문 문자열 지원
- 리소스 자동 해제
    JDK 7 이전 (리소스를 직접 해제)
        try{
            FileInputStream f = new FileInputStream("test.xml");
            BufferedReader br = new BufferedReader(new InputStreamReader(f));
            // resource open
            // to do
        }catch (Exception ex){
            // to do
        }finally{
            // resource close
            if(f != null)
                f.close();
        }
    JDK 7부터는 try with resource 구문의 추가로인해 resource들을 자동으로 close 해준다
    단, AutoClosable, Closeable 인터페이스 구현시 try(resource)내의 리소스 close()를 수행
    보통 streams, files, socket, db connection등은 해당 인터페이스를 구현해서 쓰거나..
    클래스에 AutoCloseable 을 implements AutoCloseable 하여 사용한다
        try (   
                // 꼭 아래와같이 개별적으로 변수선언과 함께 사용되어야 각각 close된다
                FileInputStream f = new FileInputStream("test.xml");
                BufferedReader br = new BufferedReader(new InputStreamReader(f));

                // 이렇게 사용할경우 FileInputStream에 대한 리소스는 해제되지 않는다
                // BufferedReader br = new BufferedReader(new InputStreamReader(new FileInputStream("test.xml"))); (X)
            ) {
            // to do
        }catch (Exception ex){
            // to do
        }


- Garbage Collector 기능 개선
- int 변수에 2진수 입력 지원
    int b = 0B10; // print 2
    int b = 0B11111111; // print 255

- 숫자 밑줄 지원
    int i = 123_456_789; // 123456789로 인식하며 가독성을 위해 사용하는 수준

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

2014
JDK 8 / Java SE 8 / JRE 8
java version 1.8.0
- Lambda 표현식 추가 (관련내용 참고 : https://jdm.kr/blog/181)
    : 식별자 없이 실행 가능한 함수 표현식
    : ( parameters ) -> { expression body }

    [기존코드]
        new Thread(new Runnable(){
            @Override
            public void run() {
            // To do ...
            }
        }).start();

    [Lambda 코드]
        new Thread(()->{
            // To do ...
        }).start();

    ex)
    // 인터페이스 작성
    @FunctionalInterface
    interface Func {
        public int calc(int a, int b)
    }

    // 람다표현식 실행함수 작성
    Func add = (int a, int b) -> a + b;

    위 처럼 사용할 경우 인퍼테이스상에 함수는 calc 하나여야만한다, 하나 이상 존재하면 오류가 날것이다
    따라서 이 인터페이스는 람다식을 위한것이다라는 표현을 위해 @FunctionalInterface 어노테이션을 사용하고
    이 어노테이션을 적용함으로서 interface상에 한개의 함수만 선언할 수 있게 된다 (하나 이상 선언시 컴파일 오류 발생)

- Streams 인터페이스 추가
    : 리스트, 배열을 대상으로 연결된 작업을 처리한다는것으로 이해됨
    1) stream 얻기
        Arrays.asList(1,2,3).stream(); // (output : 1)
        Arrays.asList(1,2,3).parallelStream(); // (output : 2) 병렬처리시 사용하며 기본적으로 CPU코어수만큼 Thread를 생성하여 동시에 작업한다

        Arrays.asList(1,2,3).stream()
                            .map(i -> i*i)
                            .forEach(System.out::println); // 1,4,9

        Arrays.asList(1,2,3).stream()
                            .limit(1)
                            .forEach(System.out::println); // 1
        
        Arrays.asList(1,2,3).stream()
                            .skip(1)
                            .forEach(System.out::println); // 2,3
        
        Arrays.asList(1,2,3).stream()
                            .filter(i -> 2>=i)
                            .forEach(System.out::println); // 1,2
        
        Arrays.asList(Arrays.asList(1,2), Arrays.asList(3,4,5), Arrays.asList(6,7,8,9)).stream()
                            .flatMap(i -> i.stream())
                            .forEach(System.out::println); // 1,2,3,4,5,6,7,8,9
        
        Arrays.asList(1,2,3).stream()
                            .reduce((a,b) -> a-b)
                            .forEach(System.out::println); // -4 ==>> ( 1 - 2 ) - 3 = -4

        // get(make) collection
        Arrays.asList(1,2,3).stream()
                            .collect(Collectors.toList());
        // get(make) collection
        Arrays.asList(1,2,3).stream()
                            .iterator();

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

2017.9월
JDK 9 / Java SE 9 / JRE 9
java version 9
- Java Platform Module System (Jigsaw) 추가
- Java 9 JShell 추가
- HTML5 Javadoc 추가
- 익명 클래스에 대한 Diamond Operator 허용
- 프로세스 API 추가

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

2018.3월 (6개월)
JDK 10 / Java SE 10 / JRE 10
java version 10
- 로벌 변수 타입 추론 (Local-Variable Type Inference) = var 변수 선언 기능
    1) 초기화 된 로컬변수 선언시 (초깃값이 없을 경우 Object로 인식)
        ex) var list = new ArrayList<String>(); // infers ArrayList<String>
        ex) var stream = list.stream();         // infers Stream<String>
    
    2) 반복문(for문, for each문)의 지역변수 선언시 사용가능
        ex) java for-each구문 에서 var 사용
            var numbers = List.of(1,2,3,4,5);
            for( var item : numbers ){
                // To do ...
            }
            or
            for( var item = 0; item < numbers.size(); i++ ){
                // To do ...
            }
    
- Garbage Collector Interface 개선
- Parallel Full GC for G1 : -XX:ParallelGCThreads 옵션을 이용해 쓰레드 수 조절
- Application Class-Data Sharing : 자바프로세스간 클래스 공유, startup 시간 단축, 메모리 최적화

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

2021.9월 JAVA 11 예정

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

RECOMMEND

REST, REST API, RESTFUL API