Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

Visual Studio Code의 Java 확장을 이용한 간단한 프로젝트 구축

Visual Studio Code 용 Java 확장이 나왔습니다.

Java Extensions for Visual Studio Code
; https://code.visualstudio.com/docs/java/extensions

Java Extension Pack
; https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack

간단하게 사용해 볼까요? ^^

일단, Java Extension Pack을 설치하고 나면 곧바로 Code 탭에 "Java Overview"가 뜨면서 "Java Development Kit Required"라는 설명과 함께 OpenJDK를 다운로드할 수 있는 버튼이 나옵니다. 기본값으로 "OpenJDK 11"이 링크되어 있는데 그냥 ^^ 변경 없이 그대로 누릅니다. (참고로, OpenJDK11U-jdk_x64_windows_hotspot_11.0.3_7.msi 다운로드는 되었는데 진행이 안 된다면 "https://www.sysnet.pe.kr/2/0/11970" 글을 참고하세요.)

그다음, "Java Extension Pack"에 포함된 "Maven for Java" 도구에서 사용할 maven을 설치해야 합니다.

Maven
; https://maven.apache.org/download.cgi
; http://apache.mirror.cdnetworks.com/maven/maven-3/3.6.1/binaries/apache-maven-3.6.1-bin.zip

JDK와 Maven이 준비되었으면 이제 JAVA_HOME 환경 변수와 maven 실행 경로를 PATH에 등록해 줍니다. 만약 환경 변수 등록이 부담스럽다면 Visual Studio Code의 Settings(Ctrl + ,)에서 "java.home"과 "maven.executable.path"를 이용해 다음과 같은 식으로 지정해도 무방합니다.

{
    "maven.executable.path": "D:\\java\\maven\\bin\\mvn.cmd",
    "java.home": "C:\\Program Files\\AdoptOpenJDK\\jdk-11.0.3.7-hotspot"
}




자, 그럼 프로젝트를 생성해야겠지요. ^^

"Ctrl + Shift + P"(또는 F1)을 눌러 "Maven: Generate from Maven Archetype" 메뉴를 선택합니다. 이어지는 메뉴에서는 "maven-archetype-quickstart"를 선택한 다음, 프로젝트가 생성될 폴더(제 경우에는 D:\temp)를 지정합니다. 중간 단계로 다음의 정보를 묻는데,

Define value for property 'groupId':
Define value for property 'artifactId':
Define value for property 'version' 1.0-SNAPSHOT: :
Define value for property 'package' : :

그냥 'groupId'와 'artifactId'에 "testapp"이라고 적고 진행하겠습니다. 나머지 물음에는 Enter 키를 쳐서 기본값으로 넘어가고 최종적으로 묻는 "Y" 단계에서 'y'키를 누르면 기본적인 maven 프로젝트 구조가 D:\temp\testapp 디렉터리에 생성되고, 프로젝트 구성을 pom.xml 파일에 담게 됩니다.

그러니까, .NET Core와 비교하자면 지금까지 "dotnet new console" 명령어로 초기 프로젝트 구성을 마친 것과 유사합니다. .NET Core의 경우 csproj 파일의 역할을 maven에서는 pom.xml 파일이 대신합니다.




이제 생성된 D:\temp\testapp\testapp 경로를 Visual Studio Code로 열고 ./src/main/java/testapp 폴더에 있는 App.java 파일을 열어,

package testapp;

public class App 
{
    public static void main( String[] args )
    {
        System.out.println( "Hello World!" );
    }
}

코드를 작성하면 됩니다. 물론 Ctrl + F5 키로 실행하거나, BraekPoint를 걸고 F5 키를 눌러 디버깅을 진행할 수 있습니다. 만약 명령행에서 실행하고 싶다면 TERMINAL 창에서 다음과 같이 입력하면 됩니다.

PS D:\temp\testapp> java -cp .\target\classes testapp.App
Hello World!

또는 (환경 변수 PATH에 mvn.cmd 경로를 등록한 경우) pom 파일이 있는 디렉터리에서 mvn install을 실행하면,

PS D:\temp\testapp> mvn install

.\target 폴더에 testapp-1.0-SNAPSHOT.jar 파일이 생성됩니다. 이렇게 생성한 jar는 다음과 같이 실행할 수 있습니다.

PS D:\temp\testapp> java -cp .\target\testapp-1.0-SNAPSHOT.jar testapp.App
Hello World!

참고로, Visual Studio Code에서도 TERMINAL에서 "mvn install"을 실행했을 때와 동일한 결과를 "Maven for Java" 확장에서 추가한 명령어("Maven: Execute commands")로 "pom.xml" 파일 선택과 함께 "install" 명령어를 수행해 얻을 수 있습니다.




(이하의 pom.xml 추가 구성은 회사 동료에게 물어서 알게 된 것입니다. ^^)

닷넷의 경우 NuGet을 통해 외부 라이브러리를 가져다 쓰는데요, maven도 이러한 패키지 라이브러리 매니저가 제공됩니다. 예를 들어, commons-codec 라이브러리를 쓰고 싶다면,

Apache Commons Codec
; https://mvnrepository.com/artifact/commons-codec/commons-codec

"Maven: Add a dependency" 메뉴를 통해 "commons-codec"을 검색어로 repo에서 제공하는 패키지를 선택합니다. (제 경우에는 "commons-codec commons-codec" 항목을 선택했습니다.) 그럼 pom.xml에 /project/dependencies 하위로 다음의 노드가 추가됩니다. (달리 말하면, "Maven: Add a dependency" 명령어를 사용하지 않고 pom.xml에 dependency 노드를 수작업으로 입력해도 됩니다.)

<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>20041127.091804</version>
</dependency>

그런데, 이상하군요. 버전이 "20041127.091804"로 나오는데, 해당 repo를 가보면,

Apache Commons Codec
; https://mvnrepository.com/artifact/commons-codec/commons-codec

2005년 11월에 나온 가장 낮은 버전이 들어 있습니다. 정책은 알 수 없지만, 어쨌든 그냥 1.12 버전으로 바꾸면 최신 버전의 라이브러리가 적용됩니다.

<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.12</version>
</dependency>

이후, 해당 라이브러리에 포함된 기능을 사용할 수 있습니다. ^^

package testapp;

import org.apache.commons.codec.binary.*;

public class App 
{
    public static void main( String[] args )
    {
        System.out.println( "Hello World!" );

        byte[] buffer = new byte[] { 0, 1, 2 };
        System.out.println(Hex.encodeHexString(buffer));
    }
}




.NET의 NuGet도 라이브러리를 로컬의 NuGet cache 폴더에 별도 보관을 하는 것처럼, Maven도 마찬가지로 다음의 폴더에 의존성을 가진 라이브러리를 다운로드해서 공유하게 됩니다.

[maven repo 경로]
%USERPROFILE%\.m2\repository

[예제에서 추가한 commons-codec 경로]
%USERPROFILE%\.m2\repository\commons-codec\commons-codec\1.10

따라서 의존성이 있는 라이브러리를 "mvn install"로 생성하는 출력 디렉터리에 포함하고 싶다면 /project/build/plugins 하위에 다음의 노드를 추가해야 합니다.

<plugin>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <phase>process-sources</phase>

            <goals>
                <goal>copy-dependencies</goal>
            </goals>

            <configuration>
                <outputDirectory>${targetdirectory}</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

이후 "mvn install" 명령어를 수행하면 ".\target\dependency" 폴더에 pom.xml에서 의존성을 가진 패키지들을 생성해 둡니다. 따라서 명령행에서 실행한다면 다음과 같이 해야 합니다.

java -cp ".\target\testapp-1.0-SNAPSHOT.jar;.\target\dependency\*"   testapp.App

나아가서, 만약 의존성이 있는 라이브러리들을 testapp-1.0-SNAPSHOT.jar 자체에 추가하고 싶다면 위의 plugin과 마찬가지로 /project/build/plugins 노드의 하위에 다음의 내용을 추가해야 합니다.

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.1.1</version>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>                        <!-- this is used for inheritance merges -->
            <phase>package</phase>                        <!-- bind to the packaging phase -->
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

그런 다음 다시 mvn install을 수행하면 .\target 폴더에 "testapp-1.0-SNAPSHOT-jar-with-dependencies.jar" 파일이 생성되고, 따라서 단일 jar 파일로 명령행에서 수행이 가능합니다.

java -cp .\target\testapp-1.0-SNAPSHOT-jar-with-dependencies.jar testapp.App

이 정도면, 앞으로 간단한 유형의 Java 프로젝트들은 쉽게 구성할 수 있을 것입니다. ^^

(첨부 파일은 이렇게 구성한 예제 프로젝트입니다.)




참고로, "Maven: Add a dependency" 명령어 수행 시 다음과 같은 오류가 발생한다면?

Commnad "maven.project.addDependency" fails. Only support POM file with single <project>node.

Visual Studio Code에서 pom.xml 파일을 열어두고 그 편집 창을 선택한 상태에서 "Maven: Add a dependency" 명령어를 실행해야 합니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]





[최초 등록일: ]
[최종 수정일: 7/7/2019 ]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer@outlook.com

비밀번호

댓글 쓴 사람
 




... 16  [17]  18  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
12035정성태10/13/20191212개발 환경 구성: 461. C# 8.0의 #nulable 관련 특성을 .NET Framework 프로젝트에서 사용하는 방법파일 다운로드1
12034정성태1/31/20201454개발 환경 구성: 460. .NET Core 환경에서 (프로젝트가 아닌) C# 코드 파일을 입력으로 컴파일하는 방법 [1]
12033정성태10/19/20202379개발 환경 구성: 459. .NET Framework 프로젝트에서 C# 8.0/9.0 컴파일러를 사용하는 방법
12032정성태11/25/20191444.NET Framework: 865. .NET Core 2.2/3.0 웹 프로젝트를 IIS에서 호스팅(Inproc, out-of-proc)하는 방법 - AspNetCoreModuleV2 소개
12031정성태10/7/2019825오류 유형: 569. Azure Site Extension 업그레이드 시 "System.IO.IOException: There is not enough space on the disk" 예외 발생
12030정성태11/12/20192847.NET Framework: 864. .NET Conf 2019 Korea - "닷넷 17년의 변화 정리 및 닷넷 코어 3.0" 발표 자료 [1]파일 다운로드1
12029정성태9/27/20191018제니퍼 .NET: 29. Jennifersoft provides a trial promotion on its APM solution such as JENNIFER, PHP, and .NET in 2019 and shares the examples of their application.
12028정성태9/26/20191201.NET Framework: 863. C# - Thread.Suspend 호출 시 응용 프로그램 hang 현상을 해결하기 위한 시도파일 다운로드1
12027정성태9/26/2019733오류 유형: 568. Consider app.config remapping of assembly "..." from Version "..." [...] to Version "..." [...] to solve conflict and get rid of warning.
12026정성태9/26/20191145.NET Framework: 862. C# - Active Directory의 LDAP 경로 및 정보 조회
12025정성태9/25/20191159제니퍼 .NET: 28. APM 솔루션 제니퍼, PHP, .NET 무료 사용 프로모션 2019 및 적용 사례 (8)
12024정성태9/20/20191330.NET Framework: 861. HttpClient와 HttpClientHandler의 관계
12023정성태9/19/20191363.NET Framework: 860. ServicePointManager.DefaultConnectionLimit와 HttpClient의 관계파일 다운로드1
12022정성태9/12/20192703개발 환경 구성: 458. C# 8.0 (Preview) 신규 문법을 위한 개발 환경 구성 [3]
12021정성태11/12/20208013도서: 시작하세요! C# 8.0 프로그래밍 [3]
12020정성태9/11/20191455VC++: 134. SYSTEMTIME 값 기준으로 특정 시간이 지났는지를 판단하는 함수
12019정성태9/11/20191036Linux: 23. .NET Core + 리눅스 환경에서 Environment.CurrentDirectory 접근 시 주의 사항
12018정성태9/25/2019906오류 유형: 567. IIS - Unrecognized attribute 'targetFramework'. Note that attribute names are case-sensitive. (D:\lowSite4\web.config line 11)
12017정성태9/11/20191387오류 유형: 566. 비주얼 스튜디오 - Failed to register URL "http://localhost:6879/" for site "..." application "/". Error description: Access is denied. (0x80070005)
12016정성태9/5/20192281오류 유형: 565. git fetch - warning: 'C:\ProgramData/Git/config' has a dubious owner: '(unknown)'.
12015정성태9/3/20193273개발 환경 구성: 457. 윈도우 응용 프로그램의 Socket 연결 시 time-out 시간 제어
12014정성태10/28/20201788개발 환경 구성: 456. 명령행에서 AWS, Azure 등의 원격 저장소에 파일 관리하는 방법 - cyberduck/duck 소개
12013정성태8/28/20191702개발 환경 구성: 455. 윈도우에서 (테스트) 인증서 파일 만드는 방법
12012정성태8/28/20192493.NET Framework: 859. C# - HttpListener를 이용한 HTTPS 통신 방법
12011정성태8/27/20191838사물인터넷: 57. C# - Rapsberry Pi Zero W와 PC 간 Bluetooth 통신 예제 코드파일 다운로드1
12010정성태8/27/20191388VS.NET IDE: 138. VSIX - DTE.ItemOperations.NewFile 메서드에서 템플릿 이름을 다국어로 설정하는 방법
... 16  [17]  18  19  20  21  22  23  24  25  26  27  28  29  30  ...