백업이란 파일을 저장할 때 이전 파일을 덮어 쓰지 않고 다른 이름으로 따로 저장해 놓는 기능이다. 파일을 수정한 후 저장했는데 수정하기 전의 내용이 필요한 경우가 종종 있다. 이럴 때 백업 기능이 반드시 필요하다. 실수로 지운 파일은 휴지통에서 찾을 수 있지만 덮어 쓴 파일은 별도의 백업을 저장해 놓지 않으면 복구할 수 없다. 그래서 대부분의 텍스트 편집기는 백업 기능을 제공한다. 백업은 호스트가 제공하는 기능이므로 ApiEdit는 특별히 수정할 필요가 없다.
당근에도 이런 백업 기능을 작성해 보되 일반적인 백업 기능보다 훨씬 더 다양한 백업 옵션을 제공할 것이다. 이전 프로젝트를 복사하여 Dangeun18프로젝트를 만들고 실습을 진행하자. 먼저 SOption에 추가할 옵션 변수들을 모두 선언한다. 이 장에서 사용할 모든 변수와 관리 코드를 한꺼번에 추가하여 예비 동작을 미리 취해 놓는다.
struct SOption
{
...
int BackupLevel;
TCHAR BackupFolder[MAX_PATH];
int BackupNaming;
int AutoSaveInterval;
BOOL bMakeEditInfo;
BOOL bUpdateEditInfo;
TCHAR EditInfoFolder[MAX_PATH];
int EditInfoMask;
BOOL bUseEditInfo;
};
SOption::Init에서 이 변수들을 초기화한다. 테스트에 필요한 값으로 초기화했으며 테스트가 끝난 후 다시 무난한 값으로 조정할 것이다.
void SOption::Init()
{
....
BackupLevel=1;
lstrcpy(BackupFolder,"");
BackupNaming=1;
AutoSaveInterval=1;
bMakeEditInfo=TRUE;
bUpdateEditInfo=TRUE;
lstrcpy(EditInfoFolder,"");
EditInfoMask=0x1f;
bUseEditInfo=TRUE;
}
Load, Save에서 이 변수들을 레지스트리에 저장한다. Setting 서브키에 저장해야 하므로 문법 강조의 스타일을 입력하기 전에 코드를 작성해야 한다. 앞장에서 추가한 bAutoConvert 변수 입출력문 다음에 코드를 추가하면 된다.
void SOption::Load(TCHAR *Key)
{
....
BackupLevel=SHRegReadInt(SHCU,szKey,"BackupLevel",0);
SHRegReadString(SHCU,szKey,"BackupFolder","",BackupFolder,256);
BackupNaming=SHRegReadInt(SHCU,szKey,"BackupNaming",0);
AutoSaveInterval=SHRegReadInt(SHCU,szKey,"AutoSaveInterval",0);
bMakeEditInfo=SHRegReadInt(SHCU,szKey,"bMakeEditInfo",0);
bUpdateEditInfo=SHRegReadInt(SHCU,szKey,"bUpdateEditInfo",0);
SHRegReadString(SHCU,szKey,"EditInfoFolder","",EditInfoFolder,256);
EditInfoMask=SHRegReadInt(SHCU,szKey,"EditInfoMask",0);
bUseEditInfo=SHRegReadInt(SHCU,szKey,"bUseEditInfo",0);
void SOption::Save(TCHAR *Key)
{
....
SHRegWriteInt(SHCU,szKey,"BackupLevel",BackupLevel);
SHRegWriteString(SHCU,szKey,"BackupFolder",BackupFolder);
SHRegWriteInt(SHCU,szKey,"BackupNaming",BackupNaming);
SHRegWriteInt(SHCU,szKey,"AutoSaveInterval",AutoSaveInterval);
SHRegWriteInt(SHCU,szKey,"bMakeEditInfo",bMakeEditInfo);
SHRegWriteInt(SHCU,szKey,"bUpdateEditInfo",bUpdateEditInfo);
SHRegWriteString(SHCU,szKey,"EditInfoFolder",EditInfoFolder);
SHRegWriteInt(SHCU,szKey,"EditInfoMask",EditInfoMask);
SHRegWriteInt(SHCU,szKey,"bUseEditInfo",bUseEditInfo);
새로 추가된 옵션이 Init에서 지정한 초기값을 가지려면 레지스트리를 비워야 하므로 설치 해제 후 다시 실행해야 한다. 그렇지 않으면 모두 SHRegRead*에서 지정한 디폴트값을 가지게 될 것이다. 개발중이므로 좀 귀찮아도 어쩔 수 없다. 다음은 이 장에서 작성할 함수의 원형들인데 함수가 추가될 때마다 헤더 파일에 일일이 원형을 선언하기 귀찮으므로 Dangeun.h에 미리 선언해 둔다.
void MakeBackupName(TCHAR *Folder,TCHAR *fname,TCHAR *ext,int level,TCHAR *szName);
void MakeBackup(TCHAR *Path);
void AutoSave();
void SaveEditings();
void MakeAssociate(TCHAR *ext, TCHAR *desc);
void UnAssociate(TCHAR *ext);
void RearrangePath();
백업 관련 변수는 다음 세 개이다. 백업 단계와 백업 파일을 저장할 위치, 백업 파일의 이름 규칙을 지정한다.
|
변수 |
설명 |
|
BackupLevel |
백업 단계이다. 다단계 백업이 가능한데 0이면 백업을 작성하지 않는다. |
|
BackupFolder |
백업 파일을 저장할 폴더이다. 빈 문자열이면 문서가 있는 폴더에 저장하는데 이렇게 하면 문서 폴더가 지저분해질 수 있으므로 별도의 폴더에 백업 파일만 따로 저장할 수도 있다. |
|
BackupNaming |
백업 파일의 이름 규칙이다. |
실제로 백업을 하는 함수를 Dangeun.cpp에 작성한다. MakeBackupName 함수는 백업 파일의 경로와 이름를 결정하는 도우미 함수이다.
void MakeBackupName(TCHAR *Folder,TCHAR *fname,TCHAR *ext,int level,TCHAR *szName)
{
TCHAR szNum[12];
// 첫 번째 백업 파일에는 숫자를 붙이진 않는다.
if (level == 1) {
szNum[0]=0;
} else {
wsprintf(szNum,"%d",level);
}
// 이름 붙이기 옵션에 따라 문자열을 조립한다.
switch (Option.BackupNaming) {
case 0:
wsprintf(szName,"%s%s.bak%s",Folder,fname,szNum);
break;
case 1:
wsprintf(szName,"%s%s_bak%s%s",Folder,fname,szNum,ext);
break;
case 2:
wsprintf(szName,"%s%s_백업%s%s",Folder,fname,szNum,ext);
break;
case 3:
wsprintf(szName,"%s%s%s.bak%s",Folder,fname,ext,szNum);
break;
}
}
인수로 전달된 폴더, 파일명, 확장자, 백업 레벨대로 백업 파일의 완전 경로를 조립하여 szName으로 리턴한다. 백업 파일의 이름은 BakcupNaming 옵션에 따라 달라지는데 원하는대로 백업 파일의 이름을 지정할 수 있다.
|
값 |
백업 파일 |
설명 |
|
0 |
File.bak |
확장자를 bak로 변경한다. |
|
1 |
File_bak.ext |
파일 이름 뒤에 _bak를 붙인다. |
|
2 |
File_백업.ext |
파일 이름 뒤에 _백업을 붙인다. |
|
3 |
File.ext.bak |
파일명과 확장자 다음에 .bak를 붙인다. |
다단계 백업시에는 일련 번호를 붙이되 1차 백업에 대해서는 번호를 붙이지 않으며 2차 백업본부터는 구분을 위해 번호를 붙인다. 백업을 작성하는 함수는 다음과 같다.
void MakeBackup(TCHAR *Path)
{
TCHAR Folder[MAX_PATH];
TCHAR drive[_MAX_DRIVE];
TCHAR dir[_MAX_DIR];
TCHAR fname[_MAX_FNAME];
TCHAR ext[_MAX_EXT];
int i;
TCHAR Src[MAX_PATH];
TCHAR Dest[MAX_PATH];
// 백업 옵션이 선택되지 않았거나 FTP 파일이면 백업하지 않는다.
if (Option.BackupLevel == 0 || strnicmp(Path,"ftp",3)==0) {
return;
}
// 백업 폴더가 지정되어 있으면 이 폴더에 백업한다.
_splitpath(Path,drive,dir,fname,ext);
if (lstrlen(Option.BackupFolder)==0 || _access(Option.BackupFolder,0)!=0) {
wsprintf(Folder,"%s%s",drive,dir);
} else {
lstrcpy(Folder,Option.BackupFolder);
if (Folder[lstrlen(Folder)-1]!='\\') {
lstrcat(Folder,"\\");
}
}
// 다단계로 백업한다. 이전 단계 백업 파일을 다음 단계로 복사한다.
for (i=Option.BackupLevel;i>0;i--) {
if (i==1) {
lstrcpy(Src,Path);
} else {
MakeBackupName(Folder,fname,ext,i-1,Src);
}
if (_access(Src,0)==0) {
MakeBackupName(Folder,fname,ext,i,Dest);
CopyFile(Src,Dest,FALSE);
}
}
}
인수로 전달된 Path 파일에 대한 백업을 옵션 변수가 지시하는대로 생성한다. 백업 레벨이 0이어서 백업 옵션이 선택되어 있지 않거나 원격지의 FTP 파일이면 백업하지 않는다. 먼저 백업 파일을 작성할 폴더를 구하는데 BackupFolder 옵션에 지정된 폴더가 존재하면 이 폴더를 사용하고 그렇지 않으면 문서가 있는 폴더를 사용한다. 백업할 폴더를 결정한 후 다단계 백업을 처리하는데 백업 파일의 끝에서부터 백업을 처리한다. 예를 들어 3차 백업까지 되어 있는 상태에서 다시 저장한다면 백업 파일들은 다음과 같이 이동된다.
|
i |
복사 원본 |
복사 대상 |
|
3 |
File.bak2 |
File.bak3 |
|
2 |
File.bak |
File.bak2 |
|
1 |
File.ext |
File.bak |
File.bak2 2차 백업 파일이 File.bak3 3차 백업 파일로 복사됨으로써 원래 3차 백업 파일은 사라진다. 1차 백업은 2차 백업으로 복사되고 원본은 1차 백업 파일이 된다. 루프는 백업 레벨의 끝에서부터 1까지 진행되며 Src에 백업 원본, Dest에 백업 대상 파일의 이름을 구한 후 CopyFile 함수로 복사한다. 단, i가 1일 때는 백업본이 아닌 원본을 1차 백업 이름으로 복사해야 한다.
백업 파일을 복사하는 중에 중간 백업 파일이 없다면 이 파일은 무시한다. 예를 들어 2차 백업 파일인 File.bak2가 없다면 이 파일을 File.bak3로 복사할 필요가 없다. 그래야 다단계로 백업을 하더라도 새로 저장되는 파일은 불필요한 백업이 생성되지 않는다. 백업할 시점은 파일을 저장할 때인데 MakeBackup에서 모든 조건을 점검하므로 호출하기만 하면 된다.
BOOL SaveToFile(HWND hChild,TCHAR *Path)
{
....
if (strnicmp(Path,"http",4)==0) {
MessageBox(hChild, "HTTP 프로토콜은 업로드를 지원하지 않으므로 이 이름으로는 "
"저장할 수 없습니다. 새 이름으로 하드 디스크에 저장하십시오","알림",MB_OK);
return FALSE;
}
MakeBackup(Path);
....
백업은 별도의 하드 디스크 공간을 사용하므로 백업 중에 용량이 부족해지는 사태가 발생할 수도 있다. 예를 들어 10K 파일을 편집해서 12K로 늘어났고 디스크 용량은 8K만 남았다고 해 보자. 이 경우 10K 크기의 백업 생성은 실패하지만 원본 파일 저장을 위해서는 2K만 더 있으면 되므로 성공할 것이다. 반대로 새로 만들어지는 백업으로 인해 원본 파일이 저장되지 못하는 특수한 경우도 있을 수 있는데 당근은 이 상황을 파일 입출력 에러로 처리한다. 좀 더 지능적으로 작성한다면 용량이 부족할 때는 백업 작성을 포기하고 원본 저장을 우선적으로 처리할 수도 있을 것이다.
자동 저장이란 주기적인 시간 간격으로 또는 일정한 조건이 되었을 때 편집 파일을 자동으로 저장하는 기능이다. 중요한 소스나 문서의 경우는 테스트중에 시스템이 다운된다거나 하는 불의의 사고로 인해 편집중인 파일을 잃을 수도 있는데 이런 사고를 방지하기 위해 자동 저장 기능을 사용할 수 있다. 자동 저장은 사용자의 명시적인 명령이 없더라도 파일을 알아서 저장하는 기능이므로 편집하던 모든 파일을 저장하는 함수가 필요하다.
void AutoSave()
{
HWND hChild;
SInfo *pSi;
// 저장 대상 파일들을 모두 저장한다.
hChild=GetWindow(g_hMDIClient,GW_CHILD);
while (hChild) {
pSi=(SInfo *)GetWindowLongPtr(hChild,0);
if (strnicmp(pSi->NowFile,"http",4) != 0 &&
strncmp(pSi->NowFile,"이름없음",8) != 0 &&
pSi->Ae.GetReadOnly() == FALSE &&
pSi->Ae.GetModified() == TRUE) {
SaveToFile(hChild,pSi->NowFile);
}
hChild=GetWindow(hChild,GW_HWNDNEXT);
}
// 현재 비활성화된 상태이면 편집 문서 정보를 다시 작성한다.
if (GetForegroundWindow() != g_hFrameWnd) {
SaveEditings();
}
}
단 저장할 수 없거나 저장할 필요가 없는 파일은 제외하는데 새로 만든 문서는 경로가 결정되지 않았으므로 자동 저장할 수 없으며 http로 다운받은 문서와 읽기 전용 문서도 저장할 수 없다. 열어 놓은 모든 문서를 순회하면서 저장 가능하면서 편집된 문서를 찾아 SaveToFile 함수를 호출하면 변경된 모든 문서가 저장될 것이다.
이 기능은 변경 감시 기능과 약간의 충돌이 있을 수 있다. 당근은 외부에서 파일을 편집할 경우를 대비하여 비활성화될 때 편집 파일 정보를 저장한다. 그런데 비활성화시에 자동 저장 기능이 동작하면 저장해 놓은 편집 파일 정보와 달라져 자신이 저장했으면서도 파일이 외부에서 변경된 것으로 잘못 인식한다. 그래서 자동 저장한 후 비활성화 상태일 때는 편집 파일 정보를 다시 조사해야 한다. 이 작업을 하는 별도의 함수를 추가한다.
// 편집중인 파일의 정보를 저장한다.
void SaveEditings()
{
HWND hChild;
SInfo *pSi;
int idx=0;
HANDLE hFile;
if (Option.bWatchChange && g_ChildNum) {
if (pEditings) {
free(pEditings);
}
pEditings=(FileInfo *)malloc(sizeof(FileInfo)*(g_ChildNum+1));
hChild=GetWindow(g_hMDIClient,GW_CHILD);
while (hChild) {
pSi=(SInfo *)GetWindowLongPtr(hChild,0);
if (strncmp(pSi->NowFile,"이름없음",8) && strnicmp(pSi->NowFile,"http",4)
&& strnicmp(pSi->NowFile,"ftp",3)) {
pEditings[idx].hWnd=hChild;
hFile=CreateFile(pSi->NowFile,0,0,NULL,
OPEN_EXISTING,FILE_ATTRIBUTE_NORMAL,NULL);
if (hFile!=INVALID_HANDLE_VALUE) {
pEditings[idx].size=GetFileSize(hFile,NULL);
GetFileTime(hFile,NULL,NULL,&pEditings[idx].st);
CloseHandle(hFile);
idx++;
}
}
hChild=GetWindow(hChild,GW_HWNDNEXT);
}
pEditings[idx].hWnd=NULL;
}
}
OnActivateApp에 있던 코드와 동일하되 편집 파일 정보가 이미 작성되어 있는 경우를 위해 pEditings를 먼저 해제한다는 점만 다르다. 자동 저장 함수에서도 편집 파일 정보를 다시 조사해야 하므로 별도의 함수로 분리했다. OnActivateApp에서는 이 함수를 대신 호출하고 지역변수 hChild는 삭제한다.
void OnActivateApp(HWND hWnd,WPARAM wParam,LPARAM lParam)
{
if (wParam) {
....
} else {
SaveEditings();
}
}
OnCreate에서 옵션 정보를 먼저 읽어 보고 자동 저장 간격이 0이 아니면 1번 타이머를 설치한다. AutoSaveInterval은 분 단위로 지정되므로 이 옵션 변수에 60*1000을 곱한 주기로 타이머를 설치해야 한다. 이 타이머는 OnDestroy에서 파괴한다.
int OnCreate(HWND hWnd,WPARAM wParam,LPARAM lParam)
{
....
if (SHRegReadInt(SHCU,KEY"Setting","StartAction",1000) == 1000) {
....
} else {
....
}
if (Option.AutoSaveInterval) {
SetTimer(hWnd,1,Option.AutoSaveInterval*1000*60,NULL);
}
....
void OnDestroy(HWND hWnd,WPARAM wParam,LPARAM lParam)
{
....
KillTimer(hWnd,1);
}
자동 저장 기능이 동작중일 때는 주기가 굉장히 느린 타이머 하나가 돌아간다. 어쨌든 자동 저장 시점이 되면 WM_TIMER 메시지가 전달될 것이고 OnTimer에서 주기적으로 자동 저장 함수를 호출한다.
void OnTimer(HWND hWnd,WPARAM wParam,LPARAM lParam)
{
....
switch (wParam) {
case 1:
AutoSave();
break;
AutoSave 함수는 변경된 모든 문서를 저장하므로 이 주기에 맞춰 모든 문서가 저장될 것이다. 자동 저장 기능이 켜져 있더라도 변경된 문서가 없으면 아무 일도 일어나지 않으므로 이 기능으로 인해 당근이 느려지거나 하지는 않는다.