Skip to content

Commit 0c66e48

Browse files
seungryeolparkmt-gitlocalize
seungryeolpark
and
mt-gitlocalize
authored
README.md translated into Korean (iluwatar#1582)
* Translate README.md via GitLocalize * Translate README.md via GitLocalize * Update README.md * Translate README.md via GitLocalize * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Translate README.md via GitLocalize * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Translate README.md via GitLocalize * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Translate README.md via GitLocalize * Update README.md Co-authored-by: mt-gitlocalize <mt@gitlocalize.com>
1 parent 8010063 commit 0c66e48

File tree

6 files changed

+861
-0
lines changed

6 files changed

+861
-0
lines changed

‎ko/README.md

Lines changed: 263 additions & 0 deletions
Large diffs are not rendered by default.

‎ko/adapter/README.md

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
---
2+
layout: pattern
3+
title: Adapter
4+
folder: adapter
5+
permalink: "/patterns/adapter/"
6+
categories: Structural
7+
tags:
8+
- Gang of Four
9+
---
10+
11+
## 또한 ~으로 알려진
12+
13+
Wrapper
14+
15+
## 의도
16+
17+
클래스의 인터페이스를 클라이언트가 기대하는 다른 인터페이스로 변환합니다. adapter를 사용하면 호환되지 않는 인터페이스로 인해 같이 쓸 수 없는 클래스를 함께 작동 할 수 있습니다.
18+
19+
## 설명
20+
21+
예시
22+
23+
> 메모리 카드에 몇 장의 사진이 있고 컴퓨터로 전송해야한다고 생각하십시오. 이들을 전송하려면 컴퓨터에 메모리 카드를 연결할 수 있도록 컴퓨터 포트와 호환되는 어댑터가 필요합니다. 이 경우 카드 리더는 어댑터입니다. 또 다른 예는 유명한 전원 어댑터입니다. 세 갈래 플러그는 두 갈래 콘센트에 연결할 수 없습니다. 두 갈래 콘센트와 호환되는 전원 어댑터를 사용해야합니다. 또 다른 예는 한 사람이 말한 단어를 다른 사람에게 번역하는 번역가입니다.
24+
25+
평범하게 말하자면
26+
27+
> adapter 패턴을 사용하면 호환되지 않는 개체를 adapter에 연결하여 다른 클래스와 호환되도록 할 수 있습니다.
28+
29+
Wikipedia 말에 의하면
30+
31+
> 소프트웨어 엔지니어링에서 adapter 패턴은 기존 클래스의 인터페이스를 다른 인터페이스로 사용할 수 있도록 하는 소프트웨어 디자인 패턴입니다. 소스 코드를 수정하지 않고 기존 클래스가 다른 클래스와 함께 작동하도록 만드는 데 자주 사용됩니다.
32+
33+
**프로그램 코드 예제**
34+
35+
조정 보트만 사용할 수 있고 전혀 항해할 수 없는 선장을 생각해보십시오.
36+
37+
먼저 `RowingBoat` 및 `FishingBoat` 인터페이스가 있습니다.
38+
39+
```java
40+
public interface RowingBoat {
41+
void row();
42+
}
43+
44+
public class FishingBoat {
45+
private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class);
46+
public void sail() {
47+
LOGGER.info("The fishing boat is sailing");
48+
}
49+
}
50+
```
51+
52+
그리고 선장은 `RowingBoat` 인터페이스를 이동할 수 있게 구현했습니다.
53+
54+
```java
55+
public class Captain {
56+
57+
private final RowingBoat rowingBoat;
58+
// default constructor and setter for rowingBoat
59+
public Captain(RowingBoat rowingBoat) {
60+
this.rowingBoat = rowingBoat;
61+
}
62+
63+
public void row() {
64+
rowingBoat.row();
65+
}
66+
}
67+
```
68+
69+
이제 해적이오고 있고 우리 선장이 탈출해야하는데 어선만 있습니다. 선장이 조정 보트 기술로 어선을 조작 할 수있는 adapter를 만들어야합니다.
70+
71+
```java
72+
public class FishingBoatAdapter implements RowingBoat {
73+
74+
private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoatAdapter.class);
75+
76+
private final FishingBoat boat;
77+
78+
public FishingBoatAdapter() {
79+
boat = new FishingBoat();
80+
}
81+
82+
@Override
83+
public void row() {
84+
boat.sail();
85+
}
86+
}
87+
```
88+
89+
이제 `Captain` 은 `FishingBoat` 를 사용하여 해적을 탈출 할 수 있습니다.
90+
91+
```java
92+
var captain = new Captain(new FishingBoatAdapter());
93+
captain.row();
94+
```
95+
96+
## 클레스 다이어그램
97+
98+
![alt text](https://github.com/warp125/java-design-patterns/blob/master/adapter/etc/adapter.urm.png?raw=true)
99+
100+
## 적용 가능성
101+
102+
다음과 같은 경우 adapter 패턴을 사용합니다.
103+
104+
- 기존 클래스를 사용 하려는데 해당 인터페이스가 필요한 클래스와 일치하지 않습니다.
105+
- 관련이 없거나 예상치 못한 클래스, 즉 호환되는 인터페이스가 반드시 필요하지 않은 클래스와 협력하는 재사용 가능한 클래스를 만들고 싶습니다.
106+
- 기존의 여러 하위 클래스를 사용해야하지만 모든 하위 클래스를 하위 클래스로 지정하여 인터페이스를 조정하는 것은 비현실적입니다. 개체 adapter는 부모 클래스의 인터페이스를 조정할 수 있습니다.
107+
- 타사 라이브러리를 사용하는 대부분의 응용 프로그램은 adapter를 응용 프로그램과 타사 라이브러리 사이의 중간 계층으로 사용하여 라이브러리에서 응용 프로그램을 분리합니다. 다른 라이브러리를 사용해야하는 경우 애플리케이션 코드를 변경할 필요없이 새 라이브러리 용 adapter만 필요합니다.
108+
109+
## 결과 :
110+
111+
클래스 및 개체 adapter에는 서로 다른 장단점이 있습니다. <br>클래스 adapter
112+
113+
- 구체적인 Adaptee 클래스를 커밋하여 Adaptee를 Target에 적용합니다. 결과적으로 클래스와 모든 하위 클래스를 조정하려는 경우 클래스 adapter가 작동하지 않습니다.
114+
- adapter는 Adaptee의 하위 클래스이기 때문에 Adaptee의 일부 동작을 오버라이드합니다.
115+
- 하나의 객체만 생성하고 adaptee를 얻기위해 위해 추가 포인터 간접 지정이 필요하지 않습니다.
116+
117+
개체 adapter
118+
119+
- 하나의 adapter가 많은 Adaptees, 즉 Adaptee 자체와 모든 하위 클래스 (있는 경우)와 함께 작동하도록합시다. adapter는 한 번에 모든 어댑터에 기능을 추가 할 수도 있습니다.
120+
- Adaptee 동작을 오버라이드하기가 더 어렵습니다. Adaptee를 서브 클래싱하고 어댑터가 Adaptee 자체가 아닌 서브 클래스를 참조하도록 해야합니다.
121+
122+
## 실제 사례
123+
124+
- [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29)
125+
- [java.util.Collections#list()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#list-java.util.Enumeration-)
126+
- [java.util.Collections#enumeration()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#enumeration-java.util.Collection-)
127+
- [javax.xml.bind.annotation.adapters.XMLAdapter](http://docs.oracle.com/javase/8/docs/api/javax/xml/bind/annotation/adapters/XmlAdapter.html#marshal-BoundType-)
128+
129+
## 크레딧
130+
131+
- [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
132+
- [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
133+
- [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
134+
- [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

‎ko/factory/README.md

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
layout: pattern
3+
title: Factory
4+
folder: factory
5+
permalink: "/patterns/factory/"
6+
categories: Creational
7+
tags:
8+
- Gang of Four
9+
---
10+
11+
## 또한 ~으로 알려진
12+
13+
- Simple Factory
14+
- Static Factory Method
15+
16+
## 의도
17+
18+
구현 논리를 숨기고 클라이언트 코드가 새 객체를 초기화하는 대신 사용에 집중하도록하기 위해 factory라는 클래스에 캡슐화 된 정적 메서드를 제공합니다.
19+
20+
## 설명
21+
22+
예시
23+
24+
> SQLServer에 연결된 웹 응용 프로그램이 있지만 이제 Oracle로 전환하려고 합니다. 기존 소스 코드를 수정하지 않고 이를 수행하려면 주어진 데이터베이스에 대한 연결을 생성하기 위해 정적 메서드를 호출 할 수 있는 Simple Factory 패턴을 구현해야합니다.
25+
26+
Wikipedia 말에 의하면
27+
28+
> factory는 다른 객체를 생성하기위한 객체입니다. 공식적으로 factory는 다양한 프로토 타입 또는 클래스의 객체를 반환하는 함수 또는 메서드입니다.
29+
30+
**프로그램 코드 예제**
31+
32+
우리는 인터페이스 `Car` 와 두 가지 구현 `Ford` 와 `Ferrari`을 가지고 있습니다.
33+
34+
```java
35+
public interface Car {
36+
String getDescription();
37+
}
38+
39+
public class Ford implements Car {
40+
41+
static final String DESCRIPTION = "This is Ford.";
42+
43+
@Override
44+
public String getDescription() {
45+
return DESCRIPTION;
46+
}
47+
}
48+
49+
public class Ferrari implements Car {
50+
51+
static final String DESCRIPTION = "This is Ferrari.";
52+
53+
@Override
54+
public String getDescription() {
55+
return DESCRIPTION;
56+
}
57+
}
58+
```
59+
60+
열거형은 우리가 지원하는 자동차 유형을 나타냅니다 ( `Ford` 및 `Ferrari` ).
61+
62+
```java
63+
public enum CarType {
64+
65+
FORD(Ford::new),
66+
FERRARI(Ferrari::new);
67+
68+
private final Supplier<Car> constructor;
69+
70+
CarType(Supplier<Car> constructor) {
71+
this.constructor = constructor;
72+
}
73+
74+
public Supplier<Car> getConstructor() {
75+
return this.constructor;
76+
}
77+
}
78+
```
79+
80+
그런 다음 factory 클래스 `CarsFactory` 캡슐화 된 자동차 객체를 만드는 정적 메서드 `getCar` 가 있습니다.
81+
82+
```java
83+
public class CarsFactory {
84+
85+
public static Car getCar(CarType type) {
86+
return type.getConstructor().get();
87+
}
88+
}
89+
```
90+
91+
이제 클라이언트 코드에서 factory 클래스를 사용하여 다양한 유형의 자동차를 만들 수 있습니다.
92+
93+
```java
94+
var car1 = CarsFactory.getCar(CarType.FORD);
95+
var car2 = CarsFactory.getCar(CarType.FERRARI);
96+
LOGGER.info(car1.getDescription());
97+
LOGGER.info(car2.getDescription());;
98+
```
99+
100+
프로그램 출력 :
101+
102+
```java
103+
This is Ford.
104+
This Ferrari.
105+
```
106+
107+
## 클래스 다이어그램
108+
109+
![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/factory/etc/factory.urm.png)
110+
111+
## 적용 가능성
112+
113+
객체 생성 및 관리 방법이 아닌 객체 생성에만 관심이있을 때 Simple Factory 패턴을 사용합니다.
114+
115+
장점
116+
117+
- 모든 객체 생성을 한곳에 유지하고 코드베이스에 '새'키 값이 확산되는 것을 방지합니다.
118+
- 느슨하게 결합 된 코드를 작성할 수 있습니다. 주요 장점 중 일부는 더 나은 테스트 가능성, 이해하기 쉬운 코드, 교체 가능한 구성 요소, 확장성 및 격리된 기능을 포함합니다.
119+
120+
단점
121+
122+
- 코드는 생각보다 복잡해집니다.
123+
124+
## 관련 패턴
125+
126+
- [Factory Method](https://java-design-patterns.com/patterns/factory-method/)
127+
- [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
128+
- [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)

0 commit comments

Comments
 (0)