jetstream-api 0.5.5__tar.gz → 0.5.6__tar.gz

{jetstream_api-0.5.5 → jetstream_api-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.5.5
+Version: 0.5.6
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.5.5 → jetstream_api-0.5.6}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.5.5"
+__version__ = "0.5.6"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

{jetstream_api-0.5.5 → jetstream_api-0.5.6}/ilink/msg.py

@@ -1269,6 +1269,27 @@ class JMSHeader:
         self.dataTypeString = dataTypeString
 
 
+def _is_rfh_bytes(data: bytes | bytearray | None) -> bool:
+    """바이트가 **RFH2 블롭으로 시작하는지** 본다.
+
+    Args:
+        data (bytes | bytearray | None): 검사할 바이트.
+
+    Returns:
+        bool: 앞 4바이트가 ``"RFH "`` 이고 길이가 고정부를 채우면 True.
+
+    Note:
+        :meth:`RFHStruct.parse` 가 쓰는 기준과 같다. 둘이 갈라지면
+        ``setData`` 가 잘못 분기하므로 함께 고쳐야 한다.
+    """
+    if data is None or len(data) < 40:
+        return False
+    try:
+        return bytes(data[:4]).decode("ascii", "replace") == ILC.RFH_STRUCID
+    except Exception:
+        return False
+
+
 class RFHStruct:
     """MQ **RFH2 헤더** 구조체. 타 MQ 제품과 연동할 때 본문 앞에 붙는다.
 
@@ -1323,7 +1344,10 @@ class RFHStruct:
             Raises:
                 ILDeserializeException: 형식이 RFH2 가 아니거나 길이가 모자랄 때.
         """
+        # 파싱은 상태를 **교체**하는 연산이다. 비우지 않으면 같은 객체로 두 번
+        # 파싱했을 때 이름-값 폴더가 누적된다(setData 를 두 번 부르면 재현).
         self.strucId = ""
+        self.nameValueList = []
         self.data = data
         if data is None or len(data) < 40:
             return
@@ -2022,10 +2046,15 @@ class ILDataMsg(ILInnerMsg):
             RFHStruct: RFH2 헤더 구조체. RFH 가 아닌 메시지면 **빈 구조체**가
             돌아온다(``None`` 이 아니다) - :meth:`RFHStruct.isRFH` 로 판정한다.
 
-        Warning:
-            **순서가 중요하다.** :meth:`setData` 는 넘어온 바이트를 RFH 로 다시
-            파싱하므로, RFH 를 채운 뒤에 ``setData`` 를 부르면 **채운 RFH 가
-            지워진다.** 본문은 생성자로 먼저 넣고 RFH 를 나중에 채운다.
+        Note:
+            **호출 순서는 상관없다.** :meth:`setData` 에 평문 본문을 주면 이미
+            채워 둔 RFH 를 그대로 두고 본문만 갈아 끼운다 - RFH 를 채운 뒤에
+            ``setData`` 를 불러도 RFH 가 살아남는다. 넘긴 바이트가 **RFH2 블롭
+            자체**일 때만 헤더까지 다시 읽는다(수신 경로가 그렇다).
+
+            0.5.5 까지는 순서를 바꾸면 RFH 가 조용히 사라졌다. 0.5.6 부터
+            고쳐졌으므로, 그 이전 버전과 함께 쓰는 코드라면 **본문을 생성자로
+            먼저 넣는** 순서를 유지하는 편이 안전하다.
 
         Note:
             :meth:`getData` 는 **RFH 를 뺀 사용자 데이터**이고
@@ -2042,8 +2071,8 @@ class ILDataMsg(ILInnerMsg):
 
                 from ilink.msg import ILDataMsg, JMSHeader
 
-                msg = ILDataMsg(JMSHeader(), None, b"<data>...</data>")  # 본문 먼저
-                msg.getRFH().setNameValueList([                          # RFH 는 그 다음
+                msg = ILDataMsg(JMSHeader(), None, b"<data>...</data>")
+                msg.getRFH().setNameValueList([
                     b"<mcd><Msd/><Set/><Type/><Fmt/></mcd>",
                     b"<usr><intf_id>MS_BIZPL</intf_id></usr>",
                 ])
@@ -2110,7 +2139,14 @@ class ILDataMsg(ILInnerMsg):
         Args:
             data (bytes | bytearray | None): 넣을 값.
         """
-        self.rfh.parse(bytes(data) if data is not None else None)
+        raw = bytes(data) if data is not None else None
+        if self.rfh.isRFH() and not _is_rfh_bytes(raw):
+            # 이미 RFH 를 채워 둔 메시지에 **평문 본문**을 넣는 경우다.
+            # parse 를 태우면 strucId 가 지워져 RFH 가 조용히 사라지므로
+            # 본문만 갈아 끼운다. 호출 순서에 상관없이 RFH 가 살아남는다.
+            self.rfh.setData(raw)
+        else:
+            self.rfh.parse(raw)
         self.data = self.rfh.getData()
         self.dataLength = self.rfh.getDataLength()
 

{jetstream_api-0.5.5 → jetstream_api-0.5.6}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.5.5
+Version: 0.5.6
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.5.5 → jetstream_api-0.5.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jetstream-api"
-version = "0.5.5"
+version = "0.5.6"
 description = "Python client API for iLink M.O.M. (Message Oriented Middleware)"
 authors = [{name = "snowjeans"}]
 readme = "README.md"