프로젝트 초기 환경세팅 및 그 외 설정

# 프로젝트 초기 환경세팅

1. 이클립스 설치

• 보통 C드라이브에 설치, 팀원과 환경을 동일하게 설치하는게 좋다.

2. 자바 JDK 환경변수 설정

• 내 컴퓨터 > 속성 > 고급시스템 설정 > 환경변수 진입
• 시스템 변수 새로만들기 클릭 후 아래 입력

변수 이름 : JAVA_HOME
변수 값 : JDK 설치 위치 (예) C:\Program Files\java\jdk1.7.0_80)

• 시스템 변수에 classpath새로 만들기 클릭

변수 이름 : classpath
변수 값 : %classPath%

• 시스템 변수에 Path 선택하여 편집

새로 만들기 클릭 후 %JAVA_HOME%\bin 이름으로 생성
생성 후 가장 상위로 올리기

• 완료 후 cmd 실행 후 아래와 같이 입력하여 정상적으로 적용 되었는지 확인

java -version
javax -version

3. 이클립스 ini 설정

• eclipse.ini 실행
• -vm 밑에 javaw.exe 경로 설정
• javaw.exe.경로 설정 (jdk가 설치된 경로로 설정) 아래와 같이 입력하여 설정

-vm
C:\Program Files\Java\jdk1.7.0_80\bin\javaw.exe

• XXMAXPermSize : JVM 클래스와 메서드를 위한 공간의 최대 크기로 XXMAXPermSize설정은 아래와 같이 진행한다.

openFile
--launcher.XXMaxPermSize
1024M
--showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
1024m

4. 이클립스 SVN 연결

• 이클립스 > windows > show view > other > svn repositories
• 우클릭 > new > new repository location 클릭 후 아래 입력

url : 공유받은 svn url입력 (예) svn://173.100.123.12/프로젝트명)
user : 공유받은 아이디 입력
password : 공유받은 비밀번호 입력
(보통 프로젝트 투입 시 프로젝트마다 지급)

5. SVN check out 및 톰캣 servers 설정

• 내려받으려는 svn 프로젝트명 > trunk 우 클릭 > SVN check out으로 내려 받기(프로젝트 사이즈에 따라 20분 가량 소요)
• SVN 내려받기 완료 후 프로젝트 실행, 실행 시 서버가 설정 안된 경우 톰캣 서버 새로 연결
  (톰캣 압축파일을 공유받은 경우 개발자가 편한 장소에 저장 후 해당 경로로 서버 잡아주기)
• 서버 연결 후 servers에서 생성한 서버 클릭하여 modules에서 path에 진행하려는 프로젝트가 정상적으로 잡혀있는지 확인, 만약 path에 잡혀있지 않은 경우 수동으로 연결(Add Web Module클릭하여 잡아주기)
• 단일 프로젝트가 아닌 경우 ports설정을 바꿔줘야 한다.

6. 이클립스 Maven Dependencies jar 파일 잡아주기

• 이클립스 자체를 공유받은게 아니라면 properties > java build path 확인
• x표시가 없도록 만들어 줘야 한다.
• 만약 maven이 x 표시인 경우 pom.xml에 의존성 주입을 해주거나 한 뒤 아래와 같이 진행

프로젝트 우 클릭 > maven > update project 클릭하여 maven updating maven project진행

7.이클립스 Maven Dependencies jar 파일 잡아주기 (오류 해결)

• Java Build Path 관련 현재 진행중인 프로젝트에서는 2개 오류 발생

ojdbc5 > ojdbc 14 존재(Nexus 등 확인 운영에서 사용하는 걸로 동일하게 변경 ojdbc 14로 변경)
egovframework.rte.fdl.logging 폴더 존재(jar 없는 경우 lib 파일 받아서 해결)

• Java Build Path 에서 Libray 순서 변경

order and Export 에서 JRE System Libray를 상위로 옮기기 (최상단 아님, Libray 중 상단)

• Java Compiler level 변경

프로젝트 우 클릭 > Properties > Java Compiler > Compiler compliance level 을 기존 1.6 에서 1.7로 상향

• 톰캣 Timeouts 설정

톰캣 Timeouts 내 Start를 기존 40~45 에서 400으로 변경

8. pom.xml

• pom.xml 의존성 주입을 위해 라이브러리에 맞는 버전을 세팅한다.
• pom.xml 에는 엑박이 나와도 되지만 그 외 .xml은 정상적으로 돌아가도록 설정해야 한다. (java Resources > src/main/resources > spring 내 xml파일들이 엑박 나오지 않도록 하기)
• pom.xml 에 정상적으로 세팅이 되었다면 프로젝트 우 클릭 > maven > Update Project 진행

9. Toad for Oracle DB연결

### Direct 방식

• 직접 접속 정보를 입력하는 방식이다. (접속정보란 오라클 서버가 설치되어있는 위치)
• context-datasource에서 db 관련 정보를 확인 후 Toad 실행 context-datasource에 있는 db 관련 정보를 확인하여 아이디와 비밀번호를 입력한다.
• Direct 클릭 후 context-datasource에 있는 Host, Port, Service Name 을 확인하여 입력한다. (프로젝트에서 공유받은 context-datasource 파일의 정보를 바탕으로 진행)

### TNS 방식

• Direct에서 입력했던 접속정보들을 미리 tnsnames.ora 에 저장해 놓고 불러서 사용하는 방식이다.
• Oracle Client 설치
• tnsnames.ora 파일 생성 후 아래와 같은 내용을 입력(예)

DB2021 = ( DESCRIPTION =
  (DEVRESS = (PROTOCOL = TCP )(HOST = 173.100.123.123)(PORT = 1234))
  (DEVRESS = (PROTOCOL = TCP )(HOST = 173.100.123.456)(PORT = 1234))
  (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = DEVDB))
)

• 환경 변수 설정

내 컴퓨터 > 속성 > 시스템 속성 > 환경 변수 > 시스템 변수 내 Path 편집
Path
ORACLE_HOME, TNS_ADMIN 추가
C:\app\user\product\11.2.0\client_1\bin (Oracle Client 설치 시 자동 추가)
%ORACLE_HOME%\bin (ORACLE_HOME)
D:\app\user\product\11.2.0\client_1\network\admin (TNS_ADMIN)

ORACLE_HOME
C:\app\user\product\11.2.0\client_1

TNS_ADMIN
tnsnames.ora의 위치
D:\app\user\product\11.2.0\client_1\network\admin

10. 로그 세팅(log4j)

• 개발을 빠르고 편리하게 할 수 있도록 도와준다.
• eGovFrame 클릭 후 src/main/java 하위에 common.logger 이름의 패키지 생성
• src/main/java에 LoggerAspect.java 파일 추가
• 프로젝트 우 클릭 > Properties > Java Build Path에 jar 파일 추가 (aspectjrt-1.5.0 / aspectjtools-1.5.0 2개)
• src/main/resources > config에 log4j.xml추가
• src/main/resourcess > dispatcher에 dispatcher-servlet.xml 추가(덮어쓰기)
• src/main/resouces > spring에 context-aop.xml 파일 추가(덮어쓰기) (만드는 방법은 인터넷 참고할 것)

 

## 그 외 프로젝트에 필요한 유용한 것

### OZ

• 리포팅 툴(보고서)

OZ Xstudio 6.0 관리자 권한으로 실행하여 설치 진행

• OZ Xstudio 설치 완료 시 C > Program Files > Forcs > OZ Xstudio > manual내에서 확인 가능 (.NET 이외 것들 참고... OZ Report Getting Developer's Guide)
• 라이센스의 경우 요청 후 전달받은 파일을 각 라이센트 폴더에 넣어서 적용. (아래 파일 참고)

ozlicense.pdf

0.29MB

### OZ Query Designer 6.0

• 보고서 디자인에 필요한 데이터 셋(ODI:OZ Data Info)을 생성할 수 있는 쿼리 디자인 도구
• DB 연결 및쿼리 개발 과정을 비 전문가도 수행할 수 있도록 구현한 질의 도구로서, 테이블 간 관계를 시각적으로 보여주며 드래그&드롭에 의한 쿼리 디자인 및 즉시 실행으로 정확한 쿼리문을 생성할 수 있도록 도와준다.
• OZ Query Designer 6.0 실행 > 파일 > 새로만들기 클릭 > db 연결을 위해 오즈 데이터 트리 내 데이터베이스에 우 클릭 > 스토어 추가 클릭하여 db 연결
• 스토어 추가한 항목에서 마우스 우 클릭 > 데이터 셋 추가 클릭하여 데이터 셋 이름을 입력하여 추가 진행
• 추가한 데이터 셋 클릭 후 왼쪽 밑 탭(연결된 db의 테이블 리스트)에서 가져올 db 드래그(또는 추가한 데이터 셋 내에서 우클릭하여 쿼리 마법사로 진행해도 된다.)
• 끌어 온 테이블에서 필요한 항목을 드래그&드롭으로 표시할 항목 필드에 넣기
• 완료 후 실행 > 쿼리 문 실행 클릭
• 완료 후 test.odi 등으로 저장(작업 폴더 경로는 C > Users > Documents > OZRepository)
• db 연결 방법은 아래와 같다.

1. 직접 연결 시

• 사용자 이름, 패스워드, 서버 주소 등 직접 입력하여 연결

2. 엘리어스 연결 (Toad TNS 연결과 비슷(접속 정보가 담긴 파일을 이용한 연결))

• 엘리어스(다른) 체크 후 db.properties(접속 정보가 담긴 파일)을 선택하여 연결
• 파일 선택 후 엘리어스 이름은 db.properties에 있는 이름과 동일하게 입력해야 접속된다. (예) 아래 파일 내용 중 엘리어스 이름 = weblogicPool)
• db.properties 경로 : C > Program Files > Forcs > OZ Xstudio 6.0 > OZRepository > db.properties
• db.properties파일 내용은 아래와 같다.

###
### DataBase Connection Pool Properties
### Last Modified : Thu Apr 18 16:30:30 GMT+09"00 2021
###

### WebLogicPool Sample ###
WebLogicPool.vendor = oracle
WebLogicPool.serverAddress = 173.100.111.123
WebLogicPool.portNo = 1234
WebLogicPool.sid = abc1
WebLogicPool.user = admin
WebLogicPool.passowrd = admin1234
WebLogicPool.maxconns = 20
WebLogicPool.initconns = 0
WebLogicPool.timeout = 5
WebLogicPool.initSqls = alter session set NLS_DATE_FORMAT = 'DD-MON-RR'
WebLogicPool.driver = weblogic.jdbc.pool.Driver
WebLogicPool.url = jdbc:weblogic:pool:aabbccPool
#
### End.

### OZ Report Designer 6.0

• 텍스트 라벨, 이미지, 바코드, 도형, 버튼, 차트, 간트 차트 등 다양한 컴포넌트를 이용하여 GUI 환경에서 시각적으로 보고서를 디자인 할 수 있도록 해주는 리포팅 디자인 도구이다.
• 동일한 보고서를 언어별로 중복하여 개발하지 않고, 하나의 보고서 파일을 다양한 언어로 적용할 수 있도록 다국어 리소스 관리 기능을 제공한다.
• 리포지토리 > 리포지토리 열기 클릭 후 아래와 같이 repository 설정 정보에 맞게 입력하여 연결.
  종류, URL, ID, PW 입력하여 연결 진행(보통 repository 설정.txt로 보관)

서버이름 : 개발
종류 : HTTP
URL : http://173.100.123.123:11100//ozserver/server
ID :admin
PW : admin1234

• 왼쪽 상단 OZ > 새로만들기 클릭
• 리포지토리 창에서 작업 폴더를 클릭하여 Query Designer에서 작업 후 젖아한 test.odi 클릭
• 밴드 추가 탭 아래방법으로 진행

새로 만들기 하여 새로 만든 파일에 밴드 추가 탭에서 타이틀 밴드, 데이터 밴드, 페이지 풋터 밴더 등 생성
보통 고객이 리포트 양식을 주면 거기에 맞게 작업한다.
작업 시 왼쪽 피로지토리 탭에서 OZ Query Designer에서 생성한 test.odi 클릭, 클릭하면 기존에 생성한 쿼리 내역이 있는데 거기서 양식에 맞게 필요한 곳에 드래그&드롭으로 진행(드래그&드롭 또는 직접 쿼리 입력도 가능하다.)
완료 후 test.ozr 등으로 저장(작업 폴더는 C > Users > user > Documents > OZRepository)
완료 후 연결된 리포지토리에 업로드 해주면 된다.

 

## 그 외 설정

### 톰캣 & JDK 메모리 설정

• 톰캣 설치경로/bin/catalina.bat 열어서 아래와 같이 진행

setlocal주석 처리 후 다음과 같이 입력(bat 파일의 주석은 :: 또는 REM을 입력한다.)
set "CATALINA_OPTS=-Xms512M -Xmx1024M -XX:PermSize=256M -XX:MaxPermSize=512M"

• Run > Run Configurations > Apache Tomcat > Arguments 내 VM arguments에 아래와 같이 입력

-Xms64m -Xmx256m

• Windows > Preferences > Java > Installed JREs > jdk 클릭 후 Edit > Default VM arguments에 아래와 같이 입력

-XX:MaxPermSize=512m

### 한글 깨짐 해결방법

• 보통 한글 깨짐 현상은 인코딩 문제로 아래와 같이 2가지의 경우가 존재한다.

1. 자바단에서 문제가 있는 경우

• 자바단에서 문제가 있는 경우에는 web.xml을 아래와 같이 수정한다.

<filter>
  <filter-name>encodingFilter</filter-name>
  <filter-class>
  	org.springframework.web.filter.CharacterEncodingFilter
  </filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>utf-8</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>encodingFilter<filter-name>
  <url-pattern>*.ex</url-pattern>
</filter-mapping>
<filter-mapping>
  <filter-name>encodingFilter<filter-name>
  <url-pattern>*.do</url-pattern>
</filter-mapping>

2. 톰캣(WAS) 설정에 문제가 있는 경우

• server.xml을 아래와 같이 수정

Servers > Tomcat vx.x Server at localhost-config > server.xml 편집
<Connector>태그에 URIEncoding="UTF-8" 추가

• web.xml을 아래와 같이 수정

Servers > Tomcat vx.x Server at localhost-config > web.xml 편집
<web-app>태그 아래에 아래와 같은 filter 추가
<filter>
  <filter-name>setCharacterEncoding</filter-name>
  <filter-class>
  	org.apache.catalina.filters.SetCharacterEncodingFilter
  </filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>utf-8</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>setCharacterEncoding</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

### 이클립스 console 출력 양 늘리기

• console 우 클릭 > Preferences
• console buffer size크기를 올려주면 console에 출력되는 양이 늘어난다.

### 이클립스 Search 결과 파일 새 창으로 오픈 설정

• 이클립스 > Window > Preferences > general > search
• Reuse editors to show matches 로 설정하면 된다.

### 토드 오라클 SQL Export

• 토드 오라클 접속
• 내려받을 쿼리 실행 후 하단 Data Grid에 Export dataset 클릭
• File에 내려받을 경로 및 파일 명 선택(~~.sql)
• 완료 후 에디트 플러스에서 실행 (다른걸로 실행해도 된다.)
• 내려받은 파일 오픈 후 기존 DB명 적혀있는 부분을 INSERT 할 DB명으로 교체한다.