개요

Project Explorer에서 server.config.xml 서버 설정 파일을 열어 설정할 수 있습니다.

server.config.xml 서버 설정 파일은 열고 하단의 각 탭을 클릭하여 해당 항목들을 설정할 수 있습니다.

주요 설정 항목은 아래와 같습니다.

주요 설정 항목

WebSquare 엔진 모듈 처리 설정

Excel, CSV 업로드/다운로드 설정

Framework 연계관련 adaptor 설정

다국어 처리 설정

WebSquare Hybrid 관련 설정

로그

각 로그 속성에 대한 설명은 아래와 같습니다.

다음은 로그 저장을 위한 websquare.xml 파일 설정 예시입니다.

$r_title(websquare.xml (설정 예))
<log>
	<target console="false" description="기본 로그" dir="C:\service\resource\websquare_home\log" 	filename="websquare" level="ALL" lineNumber="false" name="websquare" retentionPeriod="3" thread="false" />
	<target console="false" description="에러 로그" dir="C:\service\resource\websquare_home\log" 	filename="exception" level="ALL" lineNumber="false" name="exception" retentionPeriod="3" thread="false" />
</log>

Overview

encoding

default_encoding

encoding

engine

engineType

웹스퀘어 엔진의 난독화 및 압축 수준을 설정합니다. 값은 1~8까지 설정 가능합니다.

w2xType이 포함된 URL을 이용하여 직접 지정할 수 있습니다.

http://localhost:9999/websquare/websquare.html?w2xPath=/preview2.xml&w2xType=3

engineType 별 소스는 아래와 같습니다.

$r_title(engineType: 1)
WebSquare.Actions = {};
WebSquare.Actions.WebSquareAction = function(_1) {
    ["WebSquare.Actions.WebSquareAction"];
    try {
        if (arguments.length == 0) {
            return;
        }
        WebSquare.WebSquareObject.call(this, _1, true);
    } catch (e) {
        WebSquare.exception.printStackTrace(e);
    }
};

$r_title(engineType: 2)
WebSquare.Actions = {};
WebSquare.Actions.WebSquareAction = function(_1) {
    try {
        if (arguments.length == 0) {
            return;
        }
        WebSquare.WebSquareObject.call(this, _1, true);
    } catch (e) {
        WebSquare.exception.printStackTrace(e);
    }
};

$r_title(engineType: 3)
_$W._E = {};
_$W._E.WebSquareAction = function(_1) {
    ["WebSquare.Actions.WebSquareAction"];
    try {
        if (arguments.length == 0) {
            return;
        }
        _$W.WebSquareObject.call(this, _1, true);
    } catch (e) {
        _$W.exception.printStackTrace(e);
    }
};

$r_title(engineType: 4)
_$W._E = {};
_$W._E.WebSquareAction = function(_1) {
    try {
        if (arguments.length == 0) {
            return;
        }
        _$W.WebSquareObject.call(this, _1, true);
    } catch (e) {
        _$W.exception.printStackTrace(e);
    }
};

$r_title(engineType: 5)
_._E = {};
_._E.WebSquareAction = function(_1) {
    ["WebSquare.Actions.WebSquareAction"];
    try {
        if (arguments.length == 0) {
            return;
        }
        _.WebSquareObject.call(this, _1, true);
    } catch (e) {
        _.exception.printStackTrace(e);
    }
};

$r_title(engineType: 6)
_._E = {};
_._E.WebSquareAction = function(_1) {
    try {
        if (arguments.length == 0) {
            return;
        }
        _.WebSquareObject.call(this, _1, true);
    } catch (e) {
        _.exception.printStackTrace(e);
    }
};

$r_title(engineType: 7)
_$W._E = {};
_$W._E.WebSquareAction = function(_1) {
    try {
        if (arguments.length == 0) {
            return;
        }
        _$W.WebSquareObject.call(this, _1, true);
    } catch (e) {}
};

$r_title(engineType: 8)
_._E = {};
_._E.WebSquareAction = function(_1) {
    try {
        if (arguments.length == 0) {
            return;
        }
        _.WebSquareObject.call(this, _1, true);
    } catch (e) {}
};

etag

wqDefiner

date

encoding

Upload

file upload

support

useFileUpload

encoding

baseDir

subDir

$r_title(설정 예 (baseDir))
<websquare>
    <upload>
        <baseDir value="D:\upload\">      
            <subDir1 value="D:\upload\test1\" />
        </baseDir>
    </upload>
</websquare>

name

path

firstfilePostFix

duplicatedFilePostFix

sequence

maxUploadSize

subDirMaxUpload

name

path

allowedExtension

deniedExtension

uploadMode

folderName

removeKeyPath

fileDefiner

파일명과 파일 경로의 커스트마이징이 필요할 경우, 아래와 같이 추상클래스에 정의되어 있는 method를 구현합니다. 이후, 구현한 class의 전체 package 경로를 fileDefiner 속성에 설정합니다.

$r_title(설정 예 (fileDefiner))
<websquare>
    <upload>
        <fileDefiner value="site.SiteUploadFileDefinerImpl" />
    </upload>
</websquare>

$r_title(AbstractUploadFileDefiner 클래스)
package websquare.upload.handl;
public abstract class AbstractUploadFileDefiner {     
    
    abstract public String getFileName( String clientFileName, String originalFileName ) throws Exception;
     
    abstract public String getFilePath( String filePath ) throws Exception;
     
}

$r_title(구현 예시 (SiteUploadFileDefinerImpl))
package site;
import websquare.upload.handl.*;
public class SiteUploadFileDefinerImpl extends AbstractUploadFileDefiner {
     
    public String getFileName( String clientFileName, String originalFileName ) throws Exception {
        // 파일명 처리
       return originalFileName;
    }
     
    public String getFilePath( String filePath ) throws Exception {
        // 경로명 처리
        return filePath;
    }
}

decrypt

아래의 방법으로 복호화 연계를 구현할 수 있습니다.

1. 추상 클래스에 정의되어 있는 method를 구현합니다.

2. 구현한 class의 전체 package 경로를 decrypt 속성에 설정합니다. (필수)

3. 복호화를 위한 temp 디렉토리 작업 경로를 tempDir 속성에 설정합니다. (필수)

$r_title(설정 예 (decrypt))
<websquare>
    <upload>
        <decrypt value="site.SiteDefinerImpl" tempDir="temp경로"></decrypt>
    </upload>
</websquare>

$r_title(AbstractUploaDecrypter 클래스)
package websquare.upload.handl;
import java.io.*;
public abstract class AbstractUploaDecrypter {

    abstract public File decrypt( File file ) throws Exception;

}

$r_title(구현 예 (SiteDefinerImp))
package site;
import websquare.upload.handl;
public class SiteDefinerImpl extends AbstractUploaDecrypter {
     
    public String decrypt( File file ) throws Exception;
        // 복호화 처리
       return file;
    }
}

decryptTempDir

Image Upload

baseDir

multiSubDir

verifyHeader

allowedExtension

deniedExtension

imageDefiner

파일명과 파일 경로를 커스트마이징해야할 경우, 추상클래스에 정의되어 있는 method를 구현한 후 imageDefiner value속성에 구현한 class의 package 전체경로를 설정해야 합니다.

subDir (deprecated)

excel

excel upload

maxRowCount

maxCellCount

maxUploadSize

loadingMode

saxDecimal

decrypt

$r_title(설정 예 (decrypt))
<websquare>
	<csv>
		<upload>
			<decrypt value="site.SiteUploaDecrypter" tempDir="temp경로"></decrypt>
		</upload>
	</csv>
</websquare>

$r_title(AbstractUploaDecrypter 클래스)
package websquare.upload.handl;
import java.io.*;
public abstract class AbstractUploaDecrypter {
    abstract public File decrypt(File file) throws Exception;
}

$r_title(구현 예 (SiteUploaDecrypter))
package site;
import java.io.*;
import websquare.upload.handl;
public class SiteUploaDecrypter extends AbstractUploaDecrypter {
    public File decrypt(File file) throws Exception {
        // 복호화 처리
        return file;
    }
}

temp

dataConvertor

$r_title(설정 예 (dataConvertor))
<websquare>
	<excel>
		<upload>
			<dataConvertor value="site.SitecellDataProvierImpl" />
		</upload>
	</excel>
</websquare>

$r_title(ICellDataProvider)
package websquare.http.controller.grid.excel.read;
public interface ICellDataProvider {
    public String convertValue(String cellvalue) throws Exception;
}

$r_title(구현 예(SitecellDataProvierImpl))
package site;
public class SitecellDataProvierImpl implememnts ICellDataProvider {
    public String convertValue(String cellvalue) throws Exception {
        // cellvalue 수정
        return cellvalue;
    }
}

validExtension

cellDataConvertor

applyExcelFormat

dataRefine

excel download

headerColor

$r_title(설정 예)
<websquare>
    ...
    <excel>
        ...
        <headerColor value="#FF0000" /> <!-- red -->
        ...
    </excel>
</websquare>

bodyColor

$r_title(설정 예)
<websquare>
    ...
    <excel>
        ...
        <bodyColor value="#FFFF00" /> <!-- yellow -->
        ...
    </excel>
</websquare>

footerColor

$r_title(설정 예)
<websquare>
    ...
    <excel>
        ...
        <subtotalColor value="#00FFFF" /> <!-- aqua -->
        ...
    </excel>
</websquare>

subtotalColor

$r_title(설정 예)
<websquare>
    ...
    <excel>
        ...
        <footerColor value="#008000" /> <!-- green -->
        ...
    </excel>
</websquare>

maxRowCount

allowedExtension

rowAccessWindowSize

encrypt

$r_title(설정 예 (encrypt))
<websquare>
	<excel>
		<download>
			<encrypt value="site.SitetDownloadEncrypterImpl" />
		</download>
	</excel>
</websquare>

$r_title(AbstractDownloadEncrypter 클래스)
package websquare.download.handl;
import java.io.*;
import javax.servlet.http.*;
public abstract class AbstractDownloadEncrypter {
    abstract public void encrypt(BufferedInputStream is, HttpServletRequest request, HttpServletResponse response) throws Exception;
}

$r_title(구현 예 (SitetDownloadEncrypterImpl))
package site;
import websquare.download.handl;
import java.io.*;
import javax.servlet.http.*;
public class SitetDownloadEncrypterImpl extends AbstractDownloadEncrypter {
    public void encrypt(BufferedInputStream is, HttpServletRequest request, HttpServletResponse response) throws Exception {
        // 암호화 처리
        // response에 암호화 처리된 stream을 write합니다.
    }
}

tempDir

dataConvertor

$r_title(설정 예 (dataConvertor))
<websquare>
	<excel>
		<download>
			<dataConvertor value="site.SiteCellDataProviderImpl" />
		</download>
	</excel>
</websquare>

$r_title(ICellDataProvider interface)
package websquare.http.controller.grid.excel.write;

public interface ICellDataProvider {
    public String convertValue(String cellvalue) throws Exception;
}

$r_title(구현 예 (SiteCellDataProviderImpl))
package site;
import websquare.http.controller.grid.excel.write;

public SiteCellDataProviderImpl implements ICellDataProvider {
    public String convertValue(String cellvalue) throws Exception {
        // cellvalue 수정
        return cellvalue;
    }
}

dataXMLProvider

baseDir

dataTypeDate

mobile download

keyMode

preFix

$r_title(사용 예)
<keyMode value="random" preFix="SITE" />

// "random"으로 설정된 경우, 
// client에서 "randomKey"로 설정된 문자열(request.getParameter("randomKey") )에 
// "SITE" 문자열을 접두어로 붙여 key로 사용.

userAgent

definer

csv

general information

encoding

useBOM

opencsv

csv upload

maxUploadSize

decrypt

tempDir

checkEncode

csv download

keyMode

websquare 엔진 내부에서 사용하는 키 값 대신 사용자가 설정한 값을 사용하기 위한 설정.

$r_title(사용 예)
<keyMode value="random" preFix="SITE" />

// "random"으로 설정된 경우, 
// client에서 "randomKey"로 설정된 문자열(request.getParameter("randomKey") )에 
// "SITE" 문자열을 접두어로 붙여 key로 사용.

prefix

userAgent

dataConvertor

$r_title(설정 예 (dataConvertor))
<websquare>
	<csv>
		<download>
			<dataConvertor value="site.SiteCellDataProviderImpl" />
		</download>
	</csv>
</websquare>

$r_title(ICellDataProvider interface)
package websquare.http.controller.grid.write;

public interface ICellDataProvider {

    public String convertValue(String cellvalue) throws Exception;

}

$r_title(구현 예 (SiteCellDataProviderImpl))
package Site;
imports websquare.http.controller.grid.write;

public SiteCellDataProviderImpl implements ICellDataProvider {
    public String convertValue(String cellvalue) throws Exception {
        // cellvalue 수정
        return cellvalue;
    }
}

encrypt

$r_title(설정 예 (encrypt))
<websquare>
	<csv>
		<download>
			<encrypt value="site.SiteCellDataProviderImpl" />
		</download>
	</csv>
</websquare>

$r_title(AbstractDownloadEncrypter 클래스)
package websquare.download.handl;
import java.io.*;
import javax.servlet.http.*;

public abstract class AbstractDownloadEncrypter {
    abstract public void encrypt(BufferedInputStream is, HttpServletRequest request, HttpServletResponse response) throws Exception;

}

$r_title(구현 예 (SitetDownloadEncrypterImpl))
package site;

import java.io.*;
import javax.servlet.http.*;
import websquare.download.handl

public class SitetDownloadEncrypterImpl extends AbstractDownloadEncrypter {
    public void encrypt(BufferedInputStream is, HttpServletRequest request, HttpServletResponse response) throws Exception {
        // 암호화 처리
        // response에 암호화 처리된 stream을 write합니다.
    }
}

mobile download

definer

i18n

general information

baseDir

defaultLocale

domain

name

locale

localeParam

storageType

baseUrl

cache

https

keystorePath

keystoreType

keystoreaPass

xmlInfo

web2fileCacheImpl

excludeList

messageInfo

storageType

baseDir

messageImpl

resource

obfuscate

encodeParameter

fileNameBase64Decode