Java API

JAVA API 설치방법

MiPlatform JAVA API설치방법 (동영상)

MiPlatform에서 사용하는 서버 API(JAVA) 설치방법에 대해  동영상을 통해 확인할 수 있습니다.

MiPlatform API(JAVA) 설치가이드

설치 전 확인 사항

1) WAS 설치 및 Web Application(Context)가 구성이 완료 되었는지 확인 
2) FTP를 이용하여 MiPlatform-API 파일 업로드를 위한 WAS 계정 확인 
3) WAS Application(Context)의 lib 폴더 위치 확인
    예)[application 경로]/WEB-INF/lib 
4) WAS Restart 방법 확인

API 설치

WAS에 Application(Context) 구성 후 application 경로의 lib 폴더에
Service-API(miplatform-3.2.jar, commons-logging-1.1.jar)파일 업로드 후 WAS를 재기동 합니다.

상세설명

가)   WAS 권한을 가진 사용자 ID를 이용하여 WAS에 로그인
나)   WAS의 Lib 폴더로 이동 
다)   FTP 유틸리티를 통해 Jar파일 복사 (바이너리 방식으로 업로드)

※ 업로드 위치 예
    /app_test/WEB-INF/lib/miplatform-3.2.jar
    /app_test/WEB-INF/lib/commons-logging-1.1.jar 
    해당 파일은 정식제품 구매시 제공되는 모듈입니다.
라)   WAS를 Restart 합니다.

설치 확인(정상설치여부 확인)

가) 첨부파일의 설치 테스트 Jsp파일을 application의 context(Web) root에 업로드
    (JSP 파일이 호출 가능한 위치)
나) Internet Explorer 브라우저 실행
다) 주소창에 테스트 페이지 호출함(Jsp 파일 호출 가능한 웹 경로를 의미)
라) 아래 화면과 같이 xml 형태의 데이터가 브라우저에 표시되면 설치 성공

기타(워드 가이드 문서 첨부)

MiPlatform API(JAVA) 사용시 참고사항

310 API(Jar)->320 API(Jar)변경 후 Dataset Id ( input ) has no column 참고사항

마이플랫폼은 2012년 6월30일 기준 310버전의 Jar와 320 Jar를 제공하고 있습니다. 이때 다음과 같은 오류에 대한 해결방법을 기술합니다.

현상

"Dataset Id ( input ) has no column." Exception이 발생합니다 
DataSet의 컬럼정보가 생성이 되지 않은 상태에서 AddRow(AppendRow)를 한 경우에 해당 오류메시지가 발생합니다.

해결방법 1)

310 jar에서는 해당 오류메시지를 무시하였으나, 320Jar에서는 해당 오류사항을 출력하도록 하였습니다. 
기존 310의 경우 실제 오류는 발생하지 않았으나, 값을 꺼낼 수 없어 사용이 불가능한 정보였습니다. 
이에 대한 오류를 바로잡고자 해당 오류메시지를 출력하도록 하였으므로 문제가 되는 서비스의 DataSet컬럼정보를 확인하여 컬럼정보가 없는 경우 AddRow(AppendRow)하지 않토록 소스 수정이 필요합니다.

해결방법2)

DatasetHasNoColumnException 예외가 발생하지 않도록 설정하는 방법은 다음과 같습니다. 
1)  miplatform-3.2.jar 압축해제
      A.      jar xvf miplatform-3.2.jar
      B.      jar는 JDK_HOME\bin 디렉토리 위치
      C.      압축툴로도 해제 가능
2)   com\tobesoft\platform\platform.properties 파일의 다음 속성값을 false으로 변경
      A.      platform.hasNoColumnCheck=false
3)        miplatform-3.2.jar 재압축
      A.      jar cvf miplatform-3.2.jar com META-INF
      B.      com과 META-INF 디렉토리를 miplatform-3.2.jar으로 압축하겠다는 의미
      C.      알집은 jar 압축 지원

MiPlatform Java API V3.2 사용시 참고사항

V3.2 최신버전(2010년도 10월 이후) 패치 후 중복오류 발생시 확인사항

MiPlatform에서 제공하는 Java API V3.2모듈의 경우 2010년 10월 이전버전을 사용하다 2010년 10월 이후 버전으로 패치시 중복오류가 발생할 수 있습니다. 이에 대한 해결방법을 알아봅니다.

해결방법

1)  miplatform-3.2.jar  압축해제
    A. jar xvf miplatform-3.2.jar
    B. jar는 JDK_HOME\bin 디렉토리 위치
    C. 압축툴로도 해제 가능
2) com\tobesoft\platform\platform.properties 파일의 다음 속성값을 true으로 변경
    A. platform.duplicatedColumnId=true
3) miplatform-3.2.jar 재압축
    A. jar cvf miplatform-3.2.jar com META-INF
    B. com과 META-INF 디렉토리를 miplatform-3.2.jar으로 압축하겠다는 의미
    C. 알집은 jar 압축 지원

참고사항

해당 작업방법은 윈도우 OS 기준입니다. 
중복오류가 발생할 수 있는 사항

예) Select문 작성시 컴럼 또는  함수사용 후 Alias를 지정하지 않은 경우  발생

MiPlatform에서 XML로 변환시 다른 문자열로 변환되는 문자 정보

MiPlatform에서 XML로 변환시 다른 문자열로 변환되는 문자는 다음과 같습니다.

특정 서비스의 경우 XML통신시 서버에서 오류가 발생하는 경우 디버깅 방법

MiPlatform에서 데이터를 서버로 전송시 Request시 오류가 발생하는 경우 디버깅을 할 수 있습니다. 
디버깅 방법

//2009년2월 이후 Service API에서부터 지원되는 기능입니다.
// 1. 서비스에서 패킷정보를 아래와 같이 작성하도록 합니다. 
PlatformRequest req = new PlatformRequest(request, "euc-kr")

// IOException 발생시 클라이언트로부터 수신받은 데이터 스트림의 저장 여부 설정
req.setStreamLog(true);

// 클라이언트로부터 수신받은 데이터 스트림을 저장할 폴더 지정
req.setLogDir("C:\\Tmp");

// PlatformRequest.receiveData() 수행중에 IOException이 발생하는 경우 
클라이언트로부터 수신받은 데이터 스트림을 자동으로 저장함

// 데이터 스트림 저장의 최대 크기: 4M
req.receiveData();
// 정상적으로 수행되는 경우에도 데이터 스트림을 저장하기 위해서는 PlatformRequest.storeStreamLog()를 명시적으로 호출함
 
req.storeStreamLog();

마이플렛폼 API에서 DECIMAL 포멧인경우 소숫점 자리수 제한 해결방법

마이플랫폼에서 DECIMAL포멧 사용시 XML통신을 할 경우 소수점이 5자리로 제한되어 출력이 됩니다. 
이를 해결할 수 있는 방법을 알아봅니다.

발생원인

MiPlatform에서는 Decimal 형식의 소수점 10자리까지 지원하나 자바 API에서는 소수점 5자리까지만 지원하고 있다.

해결방법

사용자의 선택에 따라 MiPlatform과 동일하게 소수점 10자리까지 지원토록 하였다. 설정을 하지 않는 경우 이전과 동일하게 소수점 5자리로 표현된다.

Dataset.setDecimalPlace(소수점 자리수)
예)
ds.setDecimalPlace(10);

miplatform-3.2.jar에서 소수점 5자리 반올림 처리 방법

마이플랫폼 서비스에서 addColumn() 시 타입이 decimal일 경우 소수점 6자리 이상 데이터를 setColumn하여 넣을 경우 5자리에서 반올림되는 현상을 처리하는 방법

상세설명

• 마이플랫폼 서비스에서 addColumn() 시 decimal일 경우 소수점 6자리 이상 데이터를 setColumn하여 넣을 경우 5자리에서 반올림되는 현상을 처리하는 방법입니다.

• XML 통신일 경우 소수점 5자리 표현이 되지 않습니다. 이는 XML통신의 제약사항입니다.

• 바이너리 형태로 데이터를 내려주시면 됩니다.

• 아래와 같이 PlatformResponse를 생성시 2번째 옵션값을 조정 하시면 됩니다.

• MiPlatform에서는 Decimal 형식의 소수점 10자리까지 지원하나 자바 API에서는 소수점 5자리까지만 지원하고 있습니다.

//PlatformResponse pRes = new PlatformResponse(response, PlatformRequest.XML, char_set);
PlatformResponse pRes = new PlatformResponse(response, PlatformRequest.ZLIB_COMP, "utf-8");
설정을 하지 않는 경우 이전과 동일하게 소수점 5자리로 표현됩니다
또는,
Dataset.setDecimalPlace(소수점 자리수)
예)
ds.setDecimalPlace(10);

MiPlatform JSP(JAVA) 샘플모음

MiPlatform CRUD JSP서비스 샘플입니다.

ASP API(32/64)

MiPlatform ASP API설치방법

MiPlatform ASP API설치방법 (동영상)

MiPlatform에서 사용하는 서버 API(ASP) 설치방법에 대해  동영상을 통해 확인할 수 있습니다.

MiPlatform ASPAPI 64bit모듈 설치시 참고사항

MiPlatform ASP API모듈 설치시 참고사항입니다.

MiPlatform ASP API 64bit 모듈을 제품구입시 제공됩니다.

MiPlatform API(ASP, .Net) 사용시 참고사항

MiPlatform JSP(ASP/.NET) 샘플모음

MiPlatform CRUD ASP서비스 샘플입니다

참고사항

310 API를 이용한 샘플파일이며, 320모듈의 경우 아래 내용을 수정하시면 됩니다. 
   [수정 전]
        Set AspApi = Server.CreateObject("MIASPAPI310.Miapi") 
   [수정 후]
        Set AspApi = Server.CreateObject("MIASPAPI320.Miapi")