개발기초 넥사크로 7편 (넥사크로 공통함수 설계 방법, 유지보수와 생산성을 동시에 높이는 개발 습관)

넥사크로 공통함수, 왜 중요할까?

처음 개발을 시작했을 때는 화면 하나만 동작하면 된다고 생각했습니다.

조회 버튼을 만들고 저장 기능을 구현하고 화면이 정상적으로 동작하면 개발이 끝난 것처럼 느껴졌습니다.

하지만 프로젝트 규모가 커질수록 문제가 발생하기 시작했습니다.

동일한 메시지 함수가 여러 화면에 존재하고

조회 로직이 반복되고

날짜 검증 코드가 수십 개 화면에 복사되어 있었습니다.

처음에는 큰 문제가 아니라고 생각했지만 유지보수가 시작되자 상황이 달라졌습니다.

동일한 기능을 수정하기 위해 여러 화면을 찾아다녀야 했고 수정 누락으로 장애가 발생하기도 했습니다.

그때부터 공통함수의 중요성을 체감하게 되었습니다.

실제로 삼성전자 MES 프로젝트와 PLM 운영 업무를 수행하면서 가장 효과가 컸던 개선 중 하나가 공통함수 정리였습니다.

---

공통함수란 무엇인가

공통함수는 여러 화면에서 반복적으로 사용하는 기능을 하나로 모아 관리하는 방식입니다.

예를 들어

메시지 출력

날짜 검증

필수값 체크

Transaction 호출

권한 확인

등의 기능은 거의 모든 화면에서 사용됩니다.

이런 기능을 화면마다 각각 구현하는 것이 아니라 하나의 함수로 관리하는 것입니다.

---

중복 코드가 위험한 이유

신입 개발자 시절 가장 많이 했던 실수 중 하나입니다.

조회 전 필수값 체크 로직을 만들고

다음 화면에서도 복사하고

또 다른 화면에서도 복사했습니다.

처음에는 빠르게 개발할 수 있었습니다.

하지만 요구사항이 변경되면서 문제가 발생했습니다.

수십 개 화면을 모두 수정해야 했고 일부 화면은 수정이 누락되었습니다.

그 결과 동일한 기능인데 화면마다 동작이 달라지는 현상이 발생했습니다.

그 이후부터는 "한 번만 작성하고 여러 번 사용하자"는 원칙을 지키게 되었습니다.

---

실무에서 가장 많이 사용하는 공통함수

프로젝트를 수행하면서 거의 모든 화면에서 사용했던 함수들입니다.

메시지 출력 함수

알림창

확인창

오류 메시지

등을 통일된 형태로 출력합니다.

사용자 경험을 일관되게 유지할 수 있습니다.

---

날짜 검증 함수

시작일과 종료일 검증

조회 기간 제한

미래 날짜 체크

등에 활용합니다.

MES 프로젝트에서는 조회 기간을 제한하는 기능에 자주 사용했습니다.

---

필수 입력 체크 함수

저장 전에 필수값 입력 여부를 확인합니다.

제품코드

LOT 번호

사업장

등이 비어있는지 검사합니다.

화면마다 반복 작성하기보다 공통함수로 관리하는 것이 훨씬 효율적입니다.

---

공통 Transaction 함수

프로젝트 규모가 커질수록 효과가 큰 함수입니다.

조회

저장

삭제

등 대부분의 서버 통신을 하나의 공통 함수에서 처리합니다.

실제로 운영 프로젝트에서는 Transaction 로그 기록 기능을 공통함수에 추가하여 장애 분석 시간을 크게 줄인 경험이 있습니다.

---

공통함수 설계 경험

제가 처음 참여했던 프로젝트에서는 공통함수가 거의 존재하지 않았습니다.

개발자마다 스타일이 달랐고 동일한 기능도 구현 방식이 달랐습니다.

결과적으로 유지보수 비용이 증가했습니다.

이후 운영 프로젝트에서는

공통 Utility

공통 Validation

공통 Transaction

공통 Popup

으로 분리하여 관리했습니다.

그 결과 신규 화면 개발 시간이 눈에 띄게 단축되었습니다.

특히 신규 인력이 투입되었을 때 적응 속도가 빨라졌습니다.

---

공통함수를 너무 많이 만드는 것도 문제

공통함수가 많을수록 좋다고 생각했던 시절이 있었습니다.

하지만 경험상 무조건 그렇지는 않았습니다.

실제로 사용하지 않는 함수가 계속 쌓이기 시작했습니다.

어떤 함수는 한 화면에서만 사용되는데 공통함수로 만들어져 있었습니다.

결국 관리 대상만 늘어났습니다.

그래서 현재는

3개 이상의 화면에서 사용되는 기능

유지보수 가능성이 높은 기능

프로젝트 표준 기능

위주로 공통화를 진행합니다.

---

유지보수 관점에서 바라본 공통함수

운영 업무를 하면서 가장 크게 느낀 장점입니다.

예를 들어 메시지 출력 방식을 변경해야 한다고 가정해 보겠습니다.

공통함수가 없다면

수십 개 화면을 모두 수정해야 합니다.

공통함수가 있다면

함수 하나만 수정하면 전체 화면에 반영됩니다.

실제로 이런 경험을 여러 번 하면서 공통함수 설계가 개발 생산성보다 유지보수 효율에 더 큰 영향을 준다는 사실을 알게 되었습니다.

---

좋은 공통함수의 조건

제가 생각하는 좋은 공통함수의 기준은 다음과 같습니다.

이름만 보고 역할을 알 수 있어야 한다

특정 화면에 종속되지 않아야 한다

재사용 가능해야 한다

예외 처리 로직이 포함되어야 한다

너무 복잡하지 않아야 한다

공통함수는 결국 여러 사람이 함께 사용하는 코드이기 때문에 단순하고 명확해야 합니다.

---

마무리

넥사크로 개발을 하다 보면 처음에는 화면 구현에만 집중하게 됩니다.

하지만 프로젝트 규모가 커지고 유지보수가 시작되면 공통함수의 가치가 점점 커집니다.

저 역시 여러 MES와 PLM 프로젝트를 경험하면서 공통함수 설계가 개발 생산성과 유지보수성을 크게 좌우한다는 사실을 배웠습니다.

특히 반복되는 기능을 체계적으로 관리하면 신규 개발 속도는 물론 운영 효율까지 향상시킬 수 있습니다.

넥사크로를 공부하고 있다면 단순히 화면을 만드는 것에서 끝나지 말고 공통함수 설계 습관도 함께 익혀보길 추천합니다. 시간이 지날수록 그 가치를 더욱 크게 느끼게 될 것입니다.