nahos

3. controller / service / dao / mapper 생성

이제 마지막으로 실제 자바 소스 코드를 작성하는 부분입니다.

1. controller 파일 생성.

기본적으로 스프링 프로젝트를 생성하면 자신이 생성한 패키지명 아래에(ex com.spring.test) controller라는 폴더가 존재합니다.

또한 기본적으로 HomeController.java 파일이 존재합니다. 실행을 해보면, home.jsp파일을 화면에 띄우는 것을 확인할수있습니다.

(HomeController.java에 대한 설명 생략)

(was(톰캣...) 연동하는 부분 생략)

mybatis를 통해 쿼리문을 실행하는 것이 목표이므로, controller패키지 안에 MemberController.java파일을 생성하도록 합니다. 

MemberController.java

위와 같은 소스의 controller 파일을 만들었습니다. 

간단히 설명을 하면, 

/test/usercheck 로 호출이 가능하며, 

memberservice.userIdCheck("admin"); 를 통해 admin이란 아이디가 존재하는지 쿼리를 실행합니다.

main폴더 아래 index.jsp 파일을 호출하는 소스입니다.(jsp 호출에 관련돼서는 뒤에 설명)

2. service / serviceimpl 파일 생성

우선 기본 패키지 아래에 service라는 패키지를 생성합니다.(controller의 하위가 아닌 같은 위치)

그리고 service / serviceimpl 파일을 생성합니다.

여기서는 MemberService.java 파일과 MemberServiceImpl.java 파일을 생성합니다.

(serviceimpl파일 같은 경우 service 패키지 아래에 serviceImpl이라는 패키지를 생성하여 위치하는 경우가 많다.

어디까지나 파일의 위치가 다를뿐 만드는 사람의 자유가 아닌가 싶다.)

MemberService.java

MemberService는 인터페이스이며, 

MemberServiceImpl에서 상속받고있습니다.

MemberServiceImpl 파일에서  dao파일을 호출하고 있습니다.

(자세한 내용을 설명하려면 너무 길어지기에 간단히 설명하겠습니다.)

3.dao / daoimpl 파일 생성

위에서 service패키지를 생성하는 것과 같이 dao 패키지를 생성하고, dao / daoimpl 파일을 생성합니다.

여기서는 MemberDao.java / MemberDaoImpl.java 파일을 생성합니다.

MemberDao.java

MemberDaoImpl.java

MemberDao는 인터페이스이며, MemberDaoImpl에서 상속받고 있습니다.

MemberDaoImpl 파일에서 mapper파일(xml파일)을 호출하고 있습니다.

(dao 패키지에서는 인터페이스는 만들지 않는 경우가 더 많은 것 같습니다.

여기서는 인터페이스를 만들어서 사용하지만, 복잡하다고 생각되면, 생략하는 것이 좋을듯합니다.)

4.mapper 파일 생성

이제 실제 mybatis를 사용하여 DB에 쿼리문을 작성하여 실행하는 부분 입니다.

resources 폴더 아래에 mapper라는 폴더를 생성하고 그안에 mapper파일을 생성합니다.

여기서는 memberMapper.xml 파일을 생성합니다.

memberMapper.xml

(admin이란 테이블의 admin_id 컬럼의 값을 카운팅하는 예제로 테이블에 대한 설명은 생략합니다.)

namespace와 쿼리문의 id의 조합으로 호출이 되며, 쿼리문을 실행하고 결과를 반환합니다.

이전 글의 root-context.xml 파일에서 sqlSession의 mapperLocations의 경로를 지정했기때문에 호출이 가능합니다.

위의 MemberDaoImpl.javad에서 mapper파일의 쿼리를 'mappers.memberMapper.usercheck' 로 호출하는 것을 확인 할 수 있습니다.

결론적으로 Controller -> Service -> Dao -> Mapper 의 순서로 진행되며, 

Controller에서 받은 결과를 jsp 로 전달하는 구조입니다.

순서대로 가장 기본적인 프로젝트 셋팅이었으습니다. 

dao에서 쿼리문의 목적에 따라 selectOne이 아닌 selectList등.. 사용가능하며,

mapper파일에서 결과 또는 입력을 하기 위해 VO(domain)를 사용 하는 등 다양한 방법으로 사용가능합니다.

(사실 vo는 필수적이며, 추후 내용을 추가 하도록 하겠습니다.)

(*controller파일에서 return 값을 통해 해당 jsp를 찾는 것은 src/main/wepapp/WEB-INF/spring/appServlet/servlet-context.xml 파일에서 설정을 해줬기때문입니다.

아래 소스 부분의 수정을 통해 다른 경로를 기본 위치로 변경 할 수 있습니다.)

( https://github.com/nahosung/spring_setting )

맥북에서 젠킨스를 설치하는 방법입니다.

우선 자바가 설치되어 있어야하니, 설치를 하지 않은경우 먼저 자바 설치를 진행해야합니다.

https://jenkins.io/

위의 젠킨스 홈페이지에서 설치가 가능합니다.

다운로드 버튼을 클릭하면 아래와 같은 화면이 나오며,  (처음에 못찾고 war파일로 설치했었음)

2.19.3.war 옆에 화살표를 누르고 아래에서 선택해서 다운로드 할 수 있습니다.

1. 맥 환경이므로 Mac OS X 를 선택해서 다운로드

( 맥에서도 war 파일로 설치가 가능합니다.

1. war파일을 tomcat의 weappas 아래에 압축해제하면된다고 한다. (해보지 않음)

2. java -jar jenkins.war 명령어를 통해서도 설치 가능 )

2. 다운로드 한 pkg 파일을 실행하여 진행

설치는 어려운 부분이 없기때문에 그냥 진행을 하면됩니다. 

설치를 완료한 후 비밀번호를 입력하라는 부분이 나오면, 비밀번호를 입력하면된다.

터미널에서 아래의 경로의 파일을 통해 비밀번호를 확인하려 했는데 권한 거부를 당했다.

이땐 터미널에서 관리자 권한으로 다시 접근하면 비밀번호를 확인 가능하다 ( sudo -s )

/Users/Shared/Jenkins/Home/secrets/initialAdminPassword

플러그인을 설치하는 것을 기다리면, 젠킨스 설치가 끝났다.

(플러그인 설치를 사용자 정의로 하면 플러그인 설치 X)

*젠킨스 재시작

중지

sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist

시작

sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist

*젠킨스 포트번호 변경(기본 8080포트를 사용하기에 바꾸는 것을 추천)

sudo defaults write /Library/Preferences/org.jenkins-ci.plist httpPort 9000

(참고 페이지 : https://wiki.jenkins-ci.org/display/JENKINS/Thanks+for+using+OSX+Installer)

mybatis 사용중 아래와 같은 오류 발생

The content of elements must consist of well-formed character data or markup.

위의 오류의 원인은 < 등호 때문이다.

간단하게 <![CDATA[ 해당쿼리 ]]>

쿼리 겉에 넣어주면된다.

2. Mybatis + Mysql 설정 

프로젝트 안에 pom.xml 을 열어서 수정을 합니다. 

pom.xml 안에 dependencies 안에 아래와 같이 추가를 합니다. 

각각 mybatis , mysql , DB 에 관련이 있습니다. 

(사용되는 버전을 똑같이 할 필요 없으며,

https://mvnrepository.com/

위의 사이트에서 검색하여, 최신 혹은 많이 사용하는 버전을 사용하셔도됩니다.)

(mssql이나 oracle도 크게 다르지 않으며 검색을 통하여 위와같은 방식으로 넣어주면됩니다. 

oracle은 한가지더 추가해야하는데, 필요하신분은 검색하시면 바로 찾으실수 있습니다.)

메이븐 빌드가 완료되면 jar 파일이 설치가 완료 된 것입니다.

자동으로 메이븐 빌드가 되지 않는경우엔 프로젝트 선택 후 마우스 오른쪽 버튼 클릭 - maven - update project... 클릭

(가끔 메이븐 빌드시에 제대로 설치가 안되서 오류가 나는 경우가 있는데, 

이때는 pom.xml 에서 지웠다가 다시 설치하는 방식이 아닌, 메이븐 설치 경로에서 파일을 지워주고 

pom.xml에 다시 적어서 설치를 해야합니다.)

다음으로 root-context.xml 파일에 Mybaits에 관련된 설정을 해주도록 합니다.

(root-context.xml 파일은 src/main/wepapp/WEB-INF/spring/root-context.xml )

dataSource 는 접속하는 데이터베이스에 대한 정보 입니다. 

( mysql이라 3306포트이며 각자 자신의 환경(id,pw 포함 등..)에 맞는 설정으로 변경 )

sqlSessionFactory는 Mybatis에 대한 설정입니다.

(property name이 configLocation은 환경설정에 대한 xml 파일의 위치이며,   xml 파일은 직접 만들어야 합니다.

 property name이 mapperLocations은 실제 쿼리를 작성하는 mapper xml 파일의 위치이며, 폴더와 xml파일은 직접 만들어야 합니다.)

( sqlSessionFactory 의  configLocation 위치에 mapper 설정을 하는 경우도 있으며, 위치는 상관 없다.)

마지막으로 sqlSession 을 보면 위에서 작성한 sqlSessionFactory를, sqlSessionFactory에 dataSource를 가리키는(?) 방식이다.

(정확히 어떠한 방식으로 연결을 하고 있는지 까지는 이해를 하지 못하고 있으므로, 설정하는 방식만을 알고 넘어가겠습니다.)

이제 위에서 경로를 지정한 파일을 실제로 만들도록 합니다.

src/main/resource 경로의 아래에 mapper 라는 폴더를 생성합니다.(실제 mybatis 적용한 쿼리 xml은 나중에 생성)

그리고 위와 같은 src/main/resource 경로에 mybatis-config.xml 을 생성합니다. (파일명이나 위치는 위에서 지정한 대로 생성)

mybatis-config.xml은 위와같은 내용으로 만들며, mapper 의 위치를 이곳에 작성해도 무방하며,

mybatis에 관련 설정을 할때 xml 파일에 작성을 하면 된다.

다음은 이제 실제 스프링 소스를 작성하는 controller, service, dao, mapper 를 작성하도록 하겠습니다.

( https://github.com/nahosung/spring_setting )

이클립스 spring 프로젝트를 생성하고 mybatis 와 mysql 연결 설정하는 방법 입니다.

스프링 프로젝트를 생성하고 mybatis와 DB를 설정하는 부분은 너무 많은 글이 올라와 있지만, 

글마다 설정하는 부분의 차이도 있고 해서, 직접 해본것을 정리하여 올리는 글 입니다. 

맥북을 사용하여 설정하였으며, 이클립스 mars를 사용하고 있습니다.

( 톰캣 설치 빼고는 윈도우와 다른점은 거의 없었던걸로 기억하며, 

오히려 윈도우가 더 편한걸로 기억되니 윈도우환경도 보시는데 상관없을것 같습니다. )

1.  스프링 프로젝트를 생성 

우선 이클립스에 STS 를 설치합니다

STS 를 설치하는 방법은 상단 메뉴 - Help - Eclipse MarketPlace - sts 를 검색 - Spring Tool Suite (STS) for Eclipse ..을 다운 받습니다. 

( 버전은 달라져 있을수 있으며, 제가 받을때는 3.8.2라고 써있네요. )

설치를 완료 했으면 프로젝트를 생성 합니다 . 

상단 메뉴 - File - new - Project... 을 클릭하고, 스프링 폴더 안에 Spring Legacy Project를 클릭하고 다음 

(윈도우에서는 spring project 로 기억하고있음.)

중앙에서 Spring MVC Project 를 클릭하고 프로젝트 이름을 지정하고 다음, 패키지 명을 지정하고 프로젝트 생성.

메이븐 빌드가 완료된후 

Package Explorer에 프로젝트가 생성된것을 확인 할 수 있습니다.

톰캣으로 실행 후 웹 화면을 띄어보면 첫화면이 나오는 것을 볼 수 있습니다. 

첫번째 스프링 프로젝트 생성을 완료 했습니다.

(여기서는 메이븐 과 톰캣을 사용하고 있습니다. 

추후에 추가 예정이나 메이븐과 톰캣에 대한 설정은 따로 설명하지 않았습니다.

참고 : 맥북에서 톰캣 설치 )

다음은 이제 maven 에 mybatis와 mysql 을 추가하고, mybatis와 mysql 설정을 하도록 하겠습니다.

( https://github.com/nahosung/spring_setting )

톰캣 8.5.6 버전을 설치하여 이클립스에 서버를 올리려하는데

a tomcat 8.0 installation is expected. 와 같은 오류가 나오면서 톰캣 설정을 할 수 없는 문제가 발생

8.5.x 버전은 이클립스 tomcat8로 사용이 불가능하다고 한다. 

첫번째 해결하기 위한 방법은 홈페이지에서 8.0.x 버전을 다운받는 것이다.(추천)

두번째는 톰캣의 ServerInfo.properties 파일을 수정하는 것이다. 

ServerInfo.properties 파일은 톰캣 폴더 아래 lib/catalina.jar 파일 안에 있으므로 

catalina.jar 파일 압축을 해제한 후 ServerInfo.properties 을 열고 안에 버전을 수정을 하면된다.

server.info=Apache Tomcat/8.5.6

파일의 내용을 위에서 아래와 같이 수정하고 난 후 다시 catalina.jar 파일로 압축해주면 오류가 사라지며, 톰캣 8로 사용이 가능하다.

server.info=Apache Tomcat/8.0.5.6

그냥 8.0.x 버전을 다운 받아서 실행 하는 것을 추천

1.  톰캣 홈페이지에서 원하는 버전의 톰캣을 다운 받는다. ( http://tomcat.apache.org/  )

   core 에서 tar.gz 파일을 다운

(글쓴이는 8을 다운 받았다. 8버전을 받는다면, 8.5.6 과 8.0.38 중에 8.0.38버전을 받는 것을 추천 

그 이유는 이클립스에서 톰캣 8 서버를 설치하는데 8.5.6은 오류가 발생해서 고치는 과정이 필요하다.)

2. 다운 받은 톰캣 tar.gz 파일의 압축을 해제한다. 

(이름이 길기때문에 이름 변경후 압축 풀기를 추천, 글쓴이는 tomcat8로 변경 후 작업 )

3. 압축을 해제한 tomcat 폴더를 /usr/local 폴더로 이동시켜준다.

' sudo mv tomcat8 /usr/local ' 명령어 실행 

(/usr/local 경로가 존재하지 않으면, ' sudo mkdir /usr/local ' 명령어로 폴더 생성)

4. 톰캣의 경로를 라이브러리 쪽으로 심볼릭링크 설정을 해준다.

Library 경로에 Tomcat 폴더가 있는경우 ' sudo rm -f /Library/Tomcat ' 명령어 실행

( 처음 설치하는 경우 존재하지 않는다. )

' sudo ln -s /usr/local/tomcat8 /Library/Tomcat ' 명령어를 통해 심볼릭 링크를 설정

5. 톰캣 폴더의 소유주를 계정에 맞게 지정해주고, 톰캣 폴더 아래 bin폴더 아래의 쉘들을 실행할 권한을 준다.

' sudo chown -R <YourID> /Library/Tomcat '

' sudo chmod +x /Library/Tomcat/bin/*.sh '

마지막으로 이클립스에 톰캣을 연결해주고 실행을 해보면된다.

( 'sudo /Library/Tomcat/bin/startup.sh' 명령어를 통해 톰캣을 실행 할 수 있으며, http://127.0.0.1:8080 접속으로 톰캣 화면이 나오면 정상적으로 설치 된것 , 'sudo /Library/Tomcat/bin/shutdown.sh' 명령어로 중지 )