농부지기

[ eGov 환경설정 ]

0. 정의

    - eGov4.0 환경에 nexaN용 uiadapter 설치하기

1. nexacroN 관련 환경설정

    1. uiadapterN 환경설정

         . https://www.playnexacro.com/#show:learn:4732

     2. NexacroException 사용하기

         . https://www.playnexacro.com/#show:learn:4787

     3. Excel (xeni) 환경설정

         . https://www.playnexacro.com/#show:learn:4732 , https://www.playnexacro.com/#show:learn:4810

     4. File upload/download 환경설정

         . https://www.playnexacro.com/#show:learn:4868

2. Controller 관련 환경 설정

     1. 정의 : Controller.java 파일에 [@RequestMapping(value = "/selectSampleList.do")] 이 문장을 was가 start할때 scan해서 Container에 적제하도록 하는 설정

         - 설정하지 않으면 발생하는 오류1 : org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sampleController': Injection of resource dependencies failed; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'sampleService' available

         - 발생시점1 : tomcat start시.

         - 설정하지 않으면 발생하는 오류2 : WARN [org.springframework.web.servlet.PageNotFound] No mapping for GET /selectSampleList.do

         - 발생시점2 : 화면단에서 request 요청할 때

         - 설정파일 : context-common.xml

         - 설정내용 :

<context:component-scan base-package="sample"> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" /> </context:component-scan>

3. Query 관련 환경 설정

     1. 정의 : Query Mapper파일(xml) 경로 및 Mapper Class scan을 위한 패키지 경로 지정

         - 설정하지 않으면 발생 오류 : org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sampleService': Injection of resource dependencies failed; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'sampleMapper' available

         - 발생시점 : tomcat start시

         - 설정파일 : context-mapper.xml

         - 설정내용 :

<!-- SqlSession setup for MyBatis Database Layer --> <bean id="sqlSession" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> <property name="configLocation" value="classpath:/egovframework/sqlmap/example/sql-mapper-config.xml" /> <property name="mapperLocations" value="classpath:/egovframework/sqlmap/example/mappers/*.xml" /> </bean> <!-- MapperConfigurer setup for MyBatis Database Layer with @Mapper("deptMapper") in DeptMapper Interface --> <bean class="org.egovframe.rte.psl.dataaccess.mapper.MapperConfigurer"> <property name="basePackage" value="sample.service.impl" /> </bean>

4. transaction commit/rollback 관련 환경 설정

     1. 정의 : Dataset Rollback관련 정보 수정

         - 설정하지 않으면 발생 오류 : 

         - 발생시점 : 

         - 설정파일 : context-transaction.xml

         - 설정내용 :

<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <tx:advice id="txAdvice" transaction-manager="txManager"> <tx:attributes> <tx:method name="*" rollback-for="Exception"/> </tx:attributes> </tx:advice> <aop:config> <!-- transaction관련 소스들이 존재 한즌 impl 위치 지정 --> <aop:pointcut id="requiredTx" expression="execution(* sample..impl.*Impl.*(..))"/> <aop:advisor advice-ref="txAdvice" pointcut-ref="requiredTx" /> </aop:config>

[ eGov + nexa 연동 ]

1. eGov4.0.0 version을 사용했을 경우

    - (eGov3.10.0 , eGov3.8.0) 버전과 (egOV4.0.0)버전 간에 기본 구성은 거의 동일

    - 달라진점 : 일부 package명이 변경 됨

                         eGov3.10.0 : import egovframework.rte.psl.dataaccess.mapper.Mapper;

                         eGov4.0.0   : import org.egovframe.rte.psl.dataaccess.mapper.Mapper;

2. nexa Transaction 호출

    - url : https://www.playnexacro.com/#show:learn:4740  (eGov3.10.0)

             https://www.playnexacro.com/#show:learn:1420  (eGov3.8.0)

3. NexacroException 사용하기

    - url : https://www.playnexacro.com/#show:learn:4787   (eGov3.10.0)

             https://www.playnexacro.com/#show:learn:1465   (eGov3.8.0)

4. Excel Export, Import 사용하기

    - url : https://www.playnexacro.com/#show:learn:4810   (eGov3.10.0)

              https://www.playnexacro.com/#show:learn:1491   (eGov3.8.0)

5. File Upload, Download 사용하기

    - url : https://www.playnexacro.com/#show:learn:4868    (eGov3.10.0)

              https://www.playnexacro.com/#show:learn:1530    (eGov3.8.0)

[ eGov4.0 + uiadapterN ]

0. 정의

    - eGov4.0에 nexaN 용 uiadapter driver(jar) 설치

1. eGov4.0에 uiadaptorN  환경설정하기 - 참조 URL

   : 아래 playnexa 를 기반으로 작성 (거의 유사함 ^^)

   - url : https://www.playnexacro.com/#show:learn:4732

   - uiadpater란 : https://www.playnexacro.com/#show:learn:1385

2. eGov4.0 프로젝트 생성

    - eGovFrame Web Project 로 프로젝트 생성

    - 프로젝트명 : nexaN

    - [v] Generate Example 체크

3. eGov4.0 - Example 실행하기

    - Tomcat 9.0.45

    - java : jdk-16.0.1

      (참고, tomcat 10.0 + jdk-16.0.1 는 오류 발생)

    - db : hsql

    - mybatis

    - tomcat start

    - url : http://localhost:8080  으로 Sample 실행

4. uiadapterN 을 사용을 위한 환경설정 파일 

5. uiadapterN 환경설정

    1. java 예제 샘플 패키지 제거

    2. ibatis관련 파일 제거 (mybatis를 사용하기 위해서임)

6. context-aspect.xml 파일 설정내용 지우기

7. context-mapper.xml 

     - Mybatis관련 쿼리 xml 경로에 파일들이 아직 없기 때문에 주석처리

9. sql-mapper-config.xml

    - 기존 샘플정보는 삭제.

10. nexaN용 maven 정보

     - 참조 URL : . http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=517154

     - nexaN용 pom.xml 내용

       : 아래처럼 maven설정했을 경우 nexaN용 uiadapter가 정상적으로 작동되지 않는다.

       : 그래서, maven설정으로 하지말고 jar를 직접 down받은 후 /WEB-INF/lib 밑으로 붙여넣어서 사용해야 된다.

        . 아래 maven 설정하면 오류발생

<properties> <!-- nexacroN UIADAPTER version start --> <nexacro.uiadapter.version>1.0.1-SNAPSHOT</nexacro.uiadapter.version> <!-- nexacroN UIADAPTER version end --> </properties> <repositories> <!-- nexacroN UIADAPTER repository start --> <repository> <id>tobesoft</id> <url>http://mangosteen.tobesoft.co.kr/nexus/repository/maven-public/</url> <releases> </releases> <snapshots> </snapshots> </repository> <!-- nexacroN UIADAPTER repository end --> </repositories> <dependencies> <!-- nexacroN UIADAPTER start --> <dependency> <groupId>com.nexacro</groupId> <artifactId>uiadapter-spring-core</artifactId> <version>${nexacro.uiadapter.version}</version> </dependency> <dependency> <groupId>com.nexacro</groupId> <artifactId>uiadapter-spring-dataaccess</artifactId> <version>${nexacro.uiadapter.version}</version> </dependency> <dependency> <groupId>com.nexacro</groupId> <artifactId>uiadapter-spring-excel</artifactId> <version>${nexacro.uiadapter.version}</version> </dependency> <!-- nexacroN UIADAPTER end --> </dependencies>

     - 그래서, maven설정으로 하지말고 jar를 직접 down받은 후 /WEB-INF/lib 밑으로 붙여넣어서 사용해야 된다.

       nexaN용 jar down url : http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459">http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459

11. dispatcher-servlet.xml 

      - 파일위치 : /WEB-INF/config/egovframework/springmvc/dispatcher-servlet.xml

      - 변경사유 : uiadapter데이터 변환 처리관련 설정

                          uiadapter 모듈의 bean으로 등록하여 사용하기 위한 설정

      - 설정내용

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> <context:component-scan base-package="egovframework"> <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Service"/> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Repository"/> </context:component-scan> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"> <!-- <property name="webBindingInitializer"> <bean class="egovframework.example.cmmn.web.EgovBindingInitializer"/> </property> --> </bean> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"> <property name="interceptors"> <list> <ref bean="localeChangeInterceptor" /> </list> </property> </bean> <bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver" /> <!-- 쿠키를 이용한 Locale 이용시 <bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver"/> --> <bean id="localeChangeInterceptor" class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"> <property name="paramName" value="language" /> </bean> <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver"> <property name="defaultErrorView" value="cmmn/egovError"/> <property name="exceptionMappings"> <props> <prop key="org.springframework.dao.DataAccessException">cmmn/dataAccessFailure</prop> <prop key="org.springframework.transaction.TransactionException">cmmn/transactionFailure</prop> <prop key="egovframework.rte.fdl.cmmn.exception.EgovBizException">cmmn/egovError</prop> <prop key="org.springframework.security.AccessDeniedException">cmmn/egovError</prop> </props> </property> </bean> <bean class="org.springframework.web.servlet.view.UrlBasedViewResolver" p:order="1" p:viewClass="org.springframework.web.servlet.view.JstlView" p:prefix="/WEB-INF/jsp/egovframework/example/" p:suffix=".jsp"/> <!-- For Pagination Tag --> <!-- <bean id="imageRenderer" class="egovframework.example.cmmn.web.EgovImgPaginationRenderer"/> <bean id="paginationManager" class="egovframework.rte.ptl.mvc.tags.ui.pagination.DefaultPaginationManager"> <property name="rendererType"> <map> <entry key="image" value-ref="imageRenderer"/> </map> </property> </bean> --> <!-- /For Pagination Tag --> <mvc:view-controller path="/cmmn/validator.do" view-name="cmmn/validator"/> <!-- /////////////////////////////////// 넥사크로N UIADAPTER 설정 시작 /////////////////////////////////// --> <!-- annotation-driven 설정. --> <mvc:annotation-driven /> <bean id="nexacroInterceptor" class="com.nexacro.uiadapter.spring.core.servlet.NexacroInterceptor"/> <bean id="nexacroFileView" class="com.nexacro.uiadapter.spring.core.view.NexacroFileView" /> <bean id="nexacroView" class="com.nexacro.uiadapter.spring.core.view.NexacroView"> <property name="defaultContentType" value="PlatformXml" /> <!-- PlatformXml PlatformJson --> <property name="defaultCharset" value="UTF-8" /> </bean> <!-- 넥사크로N RequestMappingHandlerAdapter 구현체 등록 --> <bean class="com.nexacro.uiadapter.spring.core.resolve.NexacroRequestMappingHandlerAdapter" p:order="0"> <property name="customArgumentResolvers"> <list><bean class="com.nexacro.uiadapter.spring.core.resolve.NexacroMethodArgumentResolver" /></list> </property> <property name="customReturnValueHandlers"> <list> <bean class="com.nexacro.uiadapter.spring.core.resolve.NexacroHandlerMethodReturnValueHandler"> <property name="view" ref="nexacroView" /> <property name="fileView" ref="nexacroFileView" /> </bean> </list> </property> </bean> <!-- 넥사크로N EXCEPTION-RESOLVER 등록 --> <bean id="exceptionResolver" class="com.nexacro.uiadapter.spring.core.resolve.NexacroMappingExceptionResolver" p:order="1"> <property name="view" ref="nexacroView" /> <property name="shouldLogStackTrace" value="true" /> <property name="shouldSendStackTrace" value="true" /> <!-- shouldSendStackTrace 가 false 일 경우 nexacroN으로 전송되는 에러메시지 --> <!-- <property name="defaultErrorMsg" value="An Error Occured. check the ErrorCode for detail of error infomation" /> --> <property name="defaultErrorMsg" value="fail.common.msg" /> <property name="messageSource" ref="messageSource" /> </bean> <!-- /////////////////////////////////// 넥사크로N UIADAPTER 설정 끝 /////////////////////////////////// --> </beans>

12. Mybatis의 Map사용시 DB컬럼생성을 위한 Dtabase타입셋팅

    - Database 타입에 맞는 Mybatis Map 의 컬럼생성을 위해 context-nexacro.xml 파일을 생성 후 내용을 작성

    - 현재 전자정부표준프레임워크 샘플예제의 Database 는 hsqldb를 사용하기 때문에 Database 형식을 hsql 로 셋팅

    - 파일경로 : /resources/egovframework/spring/context-nexacro.xml    

    - 설정내용

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:p="http://www.springframework.org/schema/p" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd "> <bean id="applicationContextProvider" class="com.nexacro.uiadapter.spring.core.context.ApplicationContextProvider" lazy-init="false" /> <bean id="hsqlDbms" class="com.nexacro.uiadapter.spring.dao.dbms.Hsql" /> <bean id="oracleDbms" class="com.nexacro.uiadapter.spring.dao.dbms.Oracle" /> <bean id="mssqlDbms" class="com.nexacro.uiadapter.spring.dao.dbms.Mssql" /> <bean id="mysqlDbms" class="com.nexacro.uiadapter.spring.dao.dbms.Mysql" /> <bean id="tiberoDbms" class="com.nexacro.uiadapter.spring.dao.dbms.Tibero" /> <bean id="dbmsProvider" class="com.nexacro.uiadapter.spring.dao.DbVendorsProvider"> <property name="dbvendors"> <map> <entry key="HSQL Database Engine" value-ref="hsqlDbms"/> <!-- <entry key="Oracle" value-ref="oracleDbms"/> <entry key="SQL Server" value-ref="mssqlDbms"/> <entry key="MySQL" value-ref="mysqlDbms"/> <entry key="Tibero" value-ref="tiberoDbms"/> --> </map> </property> </bean> </beans>

13. Mybatis 의 Map 사용시 interceptor plugin 셋팅

     - Mybatis 의 Map 사용시 기본적으로 데이터 조회 후 결과가 없을시 컬럼을 생성하지 않는다.

     - 하지만 Mybatis 의 기능인 interceptor plugin 을 셋팅하면 쿼리 resultType 이 resultMap 일 경우 조회 결과가 없어도 해당 컬럼을 생성한다.

     - 그리하여 Mybatis 설정파일인 sql-mapper-config.xml 파일에 interceptor plugin 내용을 추가합니다

     - 파일경로 : /resources/egovframework/sqlmap/example/sql-mapper-config.xml

     - 파일내용

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- myBatis Inteceptor for get column information --> <plugins> <!-- NexacroMybatisMetaDataProvider : Executor Plugin:쿼리를 실행하며, List 형태의 데이터 조회 시 조회된 결과가 0건일 경우 결과 메타데이 터 정보를 조회 resultType이 Map 일 경우 추가적으로 메타데이터 조회를 위한 쿼리를 실행한다. --> <plugin interceptor="com.nexacro.uiadapter.spring.dao.mybatis.NexacroMybatisMetaDataProvider" /> <!-- NexacroMybatisResultSetHandler :ResultSetHandler Plugin – Executor Plugin에서 메타데이터 조회를 위해 쿼리를 실행하였을 경우에만 동작, ResultSetMetaData 와 resultType에 존재하는 필드 정보를 확인하여 메타데이터 정보를 조회 한 다. --> <plugin interceptor="com.nexacro.uiadapter.spring.dao.mybatis.NexacroMybatisResultSetHandler" /> </plugins> </configuration>

99. 오류목록 및 해결방법

1. 오류내용

     오류1:org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.web.context.support.XmlWebApplicationContext]: Constructor threw exception; nested exception is java.lang.NoClassDefFoundError: org/springframework/core/metrics/ApplicationStartup
     오류2:java.lang.NoClassDefFoundError: org/springframework/core/NativeDetector

     해결방법1 : pom.xml 에 추가

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-core</artifactId>
  <version>5.3.8</version>
</dependency>

       해결방법2 : http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459
                          위 url에서 jar를 down받은후 /WEB-INF/lib 밑으로 붙여 넣는다.

                          (nexa pom 설정이 정상적이지 않아서 필요한 jar들이 download되지 않아서 발생)
2. 오류내용
     java.lang.NoSuchMethodError: 'org.springframework.core.metrics.ApplicationStartup org.springframework.beans.factory.config.ConfigurableListableBeanFactory.getApplicationStartup()'
    해결방법 : pom.xml 에 아래내용추가
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context-support</artifactId>
    <version>5.3.8</version>
</dependency>  
       해결방법2 : http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459
                          위 url에서 jar를 down받은후 /WEB-INF/lib 밑으로 붙여 넣는다.
                          (nexa pom 설정이 정상적이지 않아서 필요한 jar들이 download되지 않아서 발생)

3. 오류내용

       오류1: 

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'nexacroFileView': Unsatisfied dependency expressed through field 'useRequestCharset'; nested exception is org.springframework.beans.factory.BeanExpressionException: Expression parsing failed; nested exception is org.springframework.expression.spel.SpelEvaluationException: EL1008E: Property or field 'EtcProperty' cannot be found on object of type 'org.springframework.beans.factory.config.BeanExpressionContext' - maybe not public or not valid?

       오류2: 
org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'nexacroView': Unsatisfied dependency expressed through field 'useRequestCharset'; nested exception is org.springframework.beans.factory.BeanExpressionException: Expression parsing failed; nested exception is org.springframework.expression.spel.SpelEvaluationException: EL1008E: Property or field 'EtcProperty' cannot be found on object of type 'org.springframework.beans.factory.config.BeanExpressionContext' - maybe not public or not valid?
       해결방법1 : 모름

       해결방법2 : http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459">http://support.tobesoft.co.kr/Support/?menu=QnA_View&postid=510459
                          위 url에서 jar를 down받은후 /WEB-INF/lib 밑으로 붙여 넣는다.
                          (nexa pom 설정이 정상적이지 않아서 필요한 jar들이 download되지 않아서 발생)

4. 오류내용

       오류: aused by: java.lang.NoClassDefFoundError: org/springframework/web/context/request/async/CallableProcessingInterceptor

       해결방법 : tomcat 삭제 후 다시 추가

[ uiadapter ]

1. uiadapter 란

    - url : https://www.playnexacro.com/#show:learn:1385

2. uiadapter 관련 문서

* eGov4.0.0 설치 및 샘플 프로젝트 만들기 *

1. url

     - https://www.egovframe.go.kr/

     - 다운로드 > 개발환경 > (4.x 다운로드) > eGovFrameDev-4.0.0-Win-64bit.exe

2. 설치 위치

     - D:\eGov\

3. eclipse.ini 환경설정

    -vm
    C:\Java\jdk-16.0.1\bin\javaw.exe

    ...

    -Xms2048m
    -Xmx2048m

6. maven 설정

    - setting.xml 파일 생성

    - 샘플용 setting.xml 파일 받기 

    - url : https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:dev4.0:gettingstarted)

    - 파일위치 : D:\eGov\maven\

    - setting.xml 파일 내부 변경

       <localRepository>D:\eGov\maven\repository</localRepository>

4. Tomcat 

    - C:\tomcat\apache-tomcat-9.0.45

       ( jdk-16.1.0, tomcat   9 : 정상 )

       ( jdk-16.1.0, tomcat 10 : 오류 )

    - Tomcat double click > Modules tab > [Edit]버튼 > 팝업 > Path [ / ] 로 변경 후 저장

5. 프로젝트 생성

    - eGovFrame Web Project

    - [v] Generate Example

    - Project > Maven -> Update Project

7. tomcat start - 오류 발생하면

    - 주로 maven용 jar파일들이 정상적으로 download가 안되는 경우

       . 해결방법 : (8. eGov 기본 maven repository 다운로드) 아래 내용 참조

    - tomcat start시 오류가 발생하면 주로 아래 4개 파일이 정상적으로 download안되는 경우에 발생

       아래 jar파일 4개를 maven repository에서  /WEB-INF/lib 밑으로  붙여 넣는다.

      . jstl-1.2.jar

      . org.egovframe.rte.ptl.mvc-4.0.0.jar

      . spring-modules-validation-0.9.jar

      . spring-webmvc-5.3.6.jar
    - project > Properties > Java Build Path > [Libraries] > [Add Library] > Web App Libraries 추가

8. eGov 기본 maven repository 다운로드

    - 만약, maven에서 jar를 down받지 못하면 아래 url를 통해서 eGov용 jar를 받을 수 있음

    - url : https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:dev4.0:gettingstarted

    - 해당 페이지에서 문자열 검색 : repository 4.0

    - D:\eGov\maven\  밑으로 붙여 넣는다.      기존 repository는 backup을 한 후 압축파일을 해제 한다.

9. 프로젝트 실행

99. 오류 목록 및 해결방법

1. 해결방법 : ?

     오류내용 : 

    Cannot invoke "org.apache.maven.index.context.IndexingContext.purge()" because "context" is null

2. 사유 : 컴파일에 사용된 Servlet API 버전과 배포 시에 사용된 tomcat의 Servlet API 버전이 차이때문에 발생.
    해결방법 : tomcat 버전에 맞는 Servlet API 버전을 프로젝트 상에서 지정하시면 됨
                       Servlet API버전에 맞는 tomcat 버전을 설치

                       (jdk-16.1.0, tomcat 10 : 오류)

                       (jdk-16.1.0, tomcat   9 : 정상)

    오류내용 : 
java.lang.ClassCastException: class org.egovframe.rte.ptl.mvc.filter.HTMLTagFilter cannot be cast to class jakarta.servlet.Filter (org.egovframe.rte.ptl.mvc.filter.HTMLTagFilter is in unnamed module of loader org.apache.catalina.loader.ParallelWebappClassLoader @ebaa6cb; jakarta.servlet.Filter is in unnamed module of loader java.net.URLClassLoader @3d494fbf)

사유 : 컴파일에 사용된 Servlet API 버전과 배포 시에 사용된 tomcat의 Servlet API 버전이 차이때문에 발생.
해결방법 : tomcat 버전에 맞는 Servlet API 버전을 프로젝트 상에서 지정하시면 됨
       Servlet API버전에 맞는 tomcat 버전을 설치

3. 해결방법 : jstl-1.2.jar(maven에 존재)를 /web-inf/lib 밑으로 붙여 넣는다.
    오류내용 : org.apache.jasper.JasperException: 절대 URI인 [http://java.sun.com/jsp/jstl/core]을(를), web.xml 또는 이 애플리케이션과 함께 배치된 JAR 파일 내에서 찾을 수 없습니다.

4. 해결방법 : spring-webmvc-5.3.6.jar(maven에 존재)를 /web-inf/lib 밑으로 붙여 넣는다.
    오류내용1 : org.apache.jasper.JasperException: 절대 URI인 [http://www.springframework.org/tags]을(를), web.xml 또는 이 애플리케이션과 함께 배치된 JAR 파일 내에서 찾을 수 없습니다.

   오류내용2: org.apache.jasper.JasperException: 절대 URI인 [http://www.springframework.org/tags/form]을(를), web.xml 또는 이 애플리케이션과 함께 배치된 JAR 파일 내에서 찾을 수 없습니다..

5. 해결방법 : org.egovframe.rte.ptl.mvc-4.0.0.jar(maven에 존재)를 /web-inf/lib 밑으로 붙여 넣는다.
    오류내용 : org.apache.jasper.JasperException: 절대 URI인 [http://egovframework.gov/ctl/ui]을(를), web.xml 또는 이 애플리케이션과 함께 배치된 JAR 파일 내에서 찾을 수 없습니다.

6. 해결방법 : spring-modules-validation-0.9.jar(maven에 존재)를 /web-inf/lib 밑으로 붙여 넣는다.

    오류내용 : org.apache.jasper.JasperException: 절대 URI인 [http://www.springmodules.org/tags/commons-validator]을(를), web.xml 또는 이 애플리케이션과 함께 배치된 JAR 파일 내에서 찾을 수 없습니다.

.

Nexacro.웹-브라우저 띄우기

1. 정의

   - nexacro에서 웹 브라우저 띄우기

2. 설명

   - nexacro에서는 exe프로그램을 실행할 수 없다.

   - nexacro에서는 explorer만 띄워진다. chrome brower를 실행할 수 없다.

   - system.execBrower() : nexacro 함수이다.

     이 함수는 window api 함수중에 브라우저를 띄우는 함수를 수행시켜 준다.

     그래서, 항상 exploer만 띄워 진다.

   - chrome에서 window.open()을 하면 chrome 팝업창이 뜨고,

     explorer에서 window.open()을 하면 explorer 팝업창이 뜬다.

3. nexacro source

    var serverUrl = this.gfn_getServerUrl(); //  http://localhost:8080/
    if (nexacro._Browser == "Runtime")
        system.execBrowser(serverUrl + "cs/sv/survey/survey.fnc?empNo=1&empNm=김길동";

     else

        window.open(serverUrl + "cs/sv/survey/survey.fnc?empNo=1&empNm=김길동", 'popEmp', 'width=1000,

           height=900, menubar=no, status=no, toolbar=no');

[ Nexacro-FrameWork1. step9. 주요 소스]

1. FarmerMDIFrame.xadl 소스 

    <?xml version="1.0" encoding="utf-8"?> <ADL version="1.2"> <TypeDefinition url="default_typedef.xml"/> <GlobalVariables url="globalvars.xml"/> <Application id="FarmerMDIFrame" codepage="utf-8" language="Korean" loginformurl="" loginformstyle="" windowopeneffect="" windowcloseeffect="" version="" tracemode="none" themeid="default.xtheme" onloadingglobalvariables="application_onloadingglobalvariables"> <Layout> <MainFrame id="mainframe" title="maintitle" defaultfont="" resizable="true" showtitlebar="true" showstatusbar="false" left="0" top="0" width="1024" height="768" showcascadestatustext="false" showcascadetitletext="false"> <VFrameSet id="vStartFrameSet" separatesize="*,0"> <Frames> <ChildFrame id="loginFrame" dragmovetype="none" showtitlebar="false" formurl="frame::loginFrame.xfdl"/> <VFrameSet id="vMainFrameSet" separatesize="50,*,50"> <Frames> <ChildFrame id="topFrame" formurl="frame::topFrame.xfdl" showtitlebar="false" dragmovetype="none"/> <HFrameSet id="hMiddleFrameSet" separatesize="240,*"> <Frames> <ChildFrame id="menuFrame" formurl="frame::leftMenuFrame.xfdl" showtitlebar="false" dragmovetype="none"/> <VFrameSet id="vWorkFrameSet" separatesize="60,*"> <Frames> <ChildFrame id="tabFrame" formurl="frame::tabFrame.xfdl" showtitlebar="false" dragmovetype="none"/> <FrameSet id="mdiFrameSet"/> </Frames> </VFrameSet> </Frames> </HFrameSet> <ChildFrame id="bottomFrame" formurl="frame::bottomFrame.xfdl" showtitlebar="false" dragmovetype="none"/> </Frames> </VFrameSet> </Frames> </VFrameSet> </MainFrame> </Layout> <ScreenInfo/> </Application> <Script type="xscript5.0"><![CDATA[ //login frame을 0 으로 하고 업무 frame(vMainFrameSet)을 보여줌 this.afn_loginPass = function() { application.mainframe.vStartFrameSet.set_separatesize("0,*"); } this.av_mainFrame; this.av_tapFrame; this.av_mdiFrameSet; this.av_allFrame; this.application_onloadingglobalvariables = function(obj:Application, e:nexacro.LoadEventInfo) { this.av_mainFrame = application.mainframe; this.av_allFrame = this.av_mainFrame.vStartFrameSet.vMainFrameSet; this.av_tapFrame = this.av_mainFrame.vStartFrameSet.vMainFrameSet.hMiddleFrameSet.vWorkFrameSet.tabFrame; this.av_mdiFrameSet = this.av_mainFrame.vStartFrameSet.vMainFrameSet.hMiddleFrameSet.vWorkFrameSet.mdiFrameSet; } //메뉴클릭 시 > 업무화면 open(interface용. tabFrame에 fn_menuOpen() 호출) this.afn_menuOpen = function(sMenuId){ var nRow = application.gds_menu.findRow("menuId", sMenuId); if (nRow < 0) return; this.av_tapFrame.form.fn_menuOpen(nRow); //이때 중간에 form object명을 넣어야 됨 (왜, 몰러??) } this.afn_callFormFunction = function(sFuncNm, sArg){ this.av_mdiFrameSet[application.gv_activeMenuId].form.fn_callFormFunction(sFuncNm, sArg); }]]></Script> </ADL>

2. globalvars.xml

    <?xml version="1.0" encoding="utf-8"?> <GlobalVariables> <Dataset id="gds_menu"> <ColumnInfo> <Column id="level" type="STRING" size="256"/> <Column id="menuId" type="STRING" size="256"/> <Column id="menuNm" type="STRING" size="256"/> <Column id="formUrl" type="STRING" size="256"/> <Column id="param" type="STRING" size="256"/> </ColumnInfo> <Rows> <Row> <Col id="level">1</Col> <Col id="menuId">A</Col> <Col id="menuNm">기준정보</Col> <Col id="formUrl"/> </Row> <Row> <Col id="level">2</Col> <Col id="menuId">A10</Col> <Col id="menuNm">공통코드</Col> <Col id="formUrl">busi::commonCode.xfdl</Col> <Col id="param">가</Col> </Row> <Row> <Col id="level">2</Col> <Col id="menuId">A11</Col> <Col id="menuNm">법인코드</Col> <Col id="formUrl">busi::subsidiary.xfdl</Col> <Col id="param">나</Col> </Row> <Row> <Col id="level">1</Col> <Col id="menuId">B</Col> <Col id="menuNm">입고관리</Col> </Row> <Row> <Col id="level">2</Col> <Col id="menuId">B10</Col> <Col id="menuNm">견적서관리</Col> <Col id="formUrl">busi::proforma.xfdl</Col> <Col id="param">다</Col> </Row> <Row> <Col id="level">2</Col> <Col id="menuId">B11</Col> <Col id="menuNm">단가관리</Col> <Col id="formUrl">busi::unitPrice.xfdl</Col> <Col id="param">라</Col> </Row> <Row> <Col id="level">2</Col> <Col id="menuId">B12</Col> <Col id="menuNm">입찰관리</Col> <Col id="formUrl">busi::bid.xfdl</Col> <Col id="param">마</Col> </Row> </Rows> </Dataset> <Dataset id="gds_openMenu"> <ColumnInfo> <Column id="level" type="STRING" size="256"/> <Column id="menuId" type="STRING" size="256"/> <Column id="menuNm" type="STRING" size="256"/> <Column id="formUrl" type="STRING" size="256"/> </ColumnInfo> </Dataset> </GlobalVariables>

3. loginFrame.xfdl

4. leftMenuFrame.xfdl 소스

   <?xml version="1.0" encoding="utf-8"?> <FDL version="1.5"> <TypeDefinition url="..\default_typedef.xml"/> <Form id="leftMenuFrame" left="0" top="0" width="240" height="668" titletext="New Form" style="background:aquamarine;"> <Layouts> <Layout> <Grid id="grd_menu" taborder="0" useinputpanel="false" left="3.33%" top="9" right="3.75%" height="651" binddataset="gds_menu" treeinitstatus="expand,all" autofittype="col" treeusecheckbox="false" oncelldblclick="grd_menu_oncelldblclick"> <Formats> <Format id="default"> <Columns> <Column size="179"/> </Columns> <Rows> <Row size="24" band="head"/> <Row size="24"/> </Rows> <Band id="head"> <Cell text="menuNm"/> </Band> <Band id="body"> <Cell displaytype="tree" text="bind:menuNm" treestartlevel="1" treelevel="bind:level"/> </Band> </Format> </Formats> </Grid> </Layout> </Layouts> <Script type="xscript5.0"><![CDATA[ //메뉴클릭 시 > 업무화면 open this.grd_menu_oncelldblclick = function(obj:Grid, e:nexacro.GridClickEventInfo) { var nChildCnt = obj.getTreeChildCount(e.row); if (nChildCnt == 0){ var sMenuId = application.gds_menu.getColumn(e.row, "menuId"); application.afn_menuOpen(sMenuId); } }]]></Script> </Form> </FDL>

5. tabFrame.xfdl

6. topFrame.xfdl

7. workMain.xfdl

[ Nexacro-FrameWork1. step5.업무중 Frame hidden처리 ]

1. 정의
   . 업무도중 업무화면을 최대한 크게 보기 위해서 top frame, bottom Frame등을
     hidden처리 하고 싶은 경우가 존재 한다.

2. 개발방법
   . topFrame, bottomFrame hidden 처리
   . topFrame만 개발하고, bottomFrame은 과제

3. ADL applicaiton  script 수정
   1. application 변수 추가
this.av_topFrame;
  
   2. this.application_onloadingglobalvariables 에 한줄 추가
this.av_topFrame    = this.av_mainFrame.vStartFrameSet.vMainFrameSet.topFrame;

4. topFrame.xfdl 수정
   1. 버튼 하나 추가, Event하나 추가
      . id    : btn_control
      . Event : fn_control
      . Text  : 숨기기
      . position : 맨 오른쪽 하단
     
   2. script

this.fn_control = function(obj:Button,  e:nexacro.ClickEventInfo)
{
 var sText = this.btn_control.text;
 
 if (sText == "숨기기"){
  //(topFrame, 업무FrameSet, bottomFrame)
  //topFrame(11)을 한 이유는 '보여주기'버튼이 보이도록 하기 위함.
  //현재 개발은 일반button이지만 실 프로젝트에서는 'image'를 이용해서  숨기기/보여주기를 해야 됨
  application.av_allFrame.set_separatesize("11,*,50");
  this.btn_control.set_top(0);
  this.btn_control.set_text("보여주기");
 }else{
  application.av_allFrame.set_separatesize("50,*,50");
  this.btn_control.set_top(28);
  this.btn_control.set_text("숨기기");
 }
}

[ Nexacro-FrameWork1. step4.Frame에서 업무화면 함수호출 ]

1. 정의
   1. frame단에서 업무화면의 함수를 호출 하는 경우가 존재 한다.
      좋은 예로,  tabpage에서 [x]를 눌러 화면을 닫을 수 있는데
      만약, 화면에서 변경된 자료가 존재 할 경우는 닫지 않는 경우가 발생한다.
      이때 tabpage를 먼저 delete하고 화면을 받으려 하다고  자료 변경건으로
      화면을 닫지 못할 경우에 tabpage는 삭제 되고, 화면이 닫혀진 문제가 발생한다.
     
   2. 이런경우 개발방법은 화면에 존재하는 함수를 호출하여 화면을 닫을 수 있는지 검사하고
      닫을 수 있는 경우에만 tabpage도 삭제 한다.
     
2. tab.xfdl
   1. 업무화면.함수 호출
   2. button 1개, Event 1개 생성
      . id    : btn_fnCall
      . Event : btn_fnCall_onclick1
   3. btn_fnCall_onclick1 script
this.btn_fnCall_onclick1 = function(obj:Button,  e:nexacro.ClickEventInfo)
{
 application.afn_callFormFunction("fn_setOutEditBox", "top에서 호출");
}

3. ADL application script
   1. function 1개 생성
   2. script
this.afn_callFormFunction = function(sFuncNm, sArg){
 this.av_mdiFrameSet[application.gv_activeMenuId].form.fn_callFormFunction(sFuncNm, sArg);
}

4. workMain.xfdl 화면
   1. function 1개 생성
   2. 화면 호출함수가
   2. script
//application(frame)에서 업무화면의 함수를 호출하고 싶을 경우에 사용되는 function
this.fn_callFormFunction = function(sFuncNm, sArg){
 return eval("this.div_work." + sFuncNm).call(this.div_work, sArg);
}

5. commonCode.xfdl 화면
   1. edit box 1개, function 1개 추가
   2. Edit box
      . id : edt_out
      Funciton : fn_setOutEditBox()
   3. script
this.fn_setOutEditBox = function(args){
 this.edt_out.set_value(args);
 return true;
}

[ Nexacro-FrameWork1. step3.메뉴와 업무화면간 parameter 연동 ]

1. tabFrame.xfdl 화면
   1. 정의 : 화면을 open시 gds_menu.param 컬럼에 존재 하는 값을 업무화면에서 받아 사용하기
   2. 기존 fn_menuOpen() 함수 변경 (이미 존재)
      . 추가 script
        newChild.biz_param    = sParam;
      . 추가 위치
        newChild.biz_menuId   = sMenuId; -> script의 다음줄
2. workMain.xfdl 화면
   1. 기존 fn_onload()함수 변경 (이미 존재)
      . 추가 script
        this.fv_param  = this.getOwnerFrame().biz_param;
      . 추가 위치
        this.fv_menuId = this.getOwnerFrame().biz_menuId; -> script의 다음줄
   2. 2개 함수 생성
      . fn_getParam()  : 업무화면에서 호출되어 param 값을 넘겨줄 function
      . fn_getMenuId() : 업무화면에서 호출되어 menuId값을 넘겨줄 function
   3. script
  
//업무화면에서 parameter값을 얻고 싶을 경우 호출되는 function
this.fn_getParam = function(){
 return this.fv_param;
}
//업무화면에서 menuid를 얻고 싶을 경우 호출되는 function
this.fn_getMenuId = function(){
 return this.fv_menuId;
}

3. commonCode.xfdl 화면
   1. 정의 : 업무화면에서 menu에서 넘겨준 param값을 확인하기
   2. Event 1개 생성
      . fn_onload
   3. script

this.fn_onload = function(obj:Form, e:nexacro.LoadEventInfo)
{
 trace(this.parent.fn_getParam());
}