ربط Java و .NET عبر Gateways

Gateways هي جسور تربط بين IRIS ولغات خارجية.

Set gw = ##class(%Net.Remote.Gateway).%New()
Set gw.Server = "localhost"
Set gw.Port = 55555
Set sc = gw.Connect()
Set obj = gw.LoadClass("com.example.MyClass").%New()
Write obj.myMethod("Hello")
Do gw.Disconnect()

إعداد واستخدام Java Gateway عملياً.

ClassMethod CreateExcel() {
  Set gw = ^%JavaGateway
  Set wbClass = gw.LoadClass("org.apache.poi.xssf.usermodel.XSSFWorkbook")
  Set wb = wbClass.%New()
  Set sheet = wb.CreateSheet("Data")
  Set row = sheet.CreateRow(0)
  Do row.createCell(0).setCellValue("Hello")
}

عند العمل عبر Gateways، تحتاج لتحويل أنواع البيانات بين ObjectScript و Java.

// تحويل أنواع البيانات
// String ↔ Java String
Set javaStr = gw.CreateString("مرحباً")
Set objStr = javaStr.toString()

// Number ↔ Java Integer
Set javaInt = gw.CreateInteger(42)
Set num = javaInt.intValue()

// Array ↔ Java ArrayList
Set javaList = gw.LoadClass("java.util.ArrayList").%New()
Do javaList.add("عنصر 1")
Do javaList.add("عنصر 2")
Write "الحجم: ", javaList.size(), !

استخدام Gateways بكفاءة يتطلب اتباع أفضل الممارسات.

• إدارة الاتصالات: أعد استخدام الاتصالات بدلاً من إنشاء اتصال جديد لكل طلب
• معالجة الأخطاء: تعامل مع أخطاء الشبكة والاتصال
• تنظيف الموارد: أغلق الاتصالات عند الانتهاء
• التوافق: تأكد من توافق إصدارات Java

// Connection Pooling
ClassMethod GetGateway() {
  If '$Data(^%GatewayPool) {
    Set gw = ##class(%Net.Remote.Gateway).%New()
    Set gw.Server = "localhost"
    Set gw.Port = 55555
    Set sc = gw.Connect()
    Set ^%GatewayPool = gw
  }
  Return ^%GatewayPool
}

عند العمل عبر Gateways، تحتاج لتحويل أنواع البيانات بين ObjectScript و Java/.NET.

تحويل الأنواع الشائعة

// String ↔ Java String
Set javaStr = gw.CreateString("مرحباً")
Set objStr = javaStr.toString()

// Number ↔ Java Integer  
Set javaInt = gw.CreateInteger(42)
Set num = javaInt.intValue()

// Array ↔ Java ArrayList
Set javaList = gw.LoadClass("java.util.ArrayList").%New()
Do javaList.add("عنصر 1")
Do javaList.add("عنصر 2")
Write "الحجم: ", javaList.size(), !

// Date ↔ Java Date
Set javaDate = gw.LoadClass("java.util.Date").%New()
Write "التاريخ: ", javaDate.toString(), !

استخدام Gateways بكفاءة يتطلب اتباع أفضل الممارسات لضمان الأداء والموثوقية.

Connection Pooling

// إعادة استخدام الاتصالات بدلاً من إنشاء اتصال جديد
ClassMethod GetGateway() As %Net.Remote.Gateway {
  If '$Data(^%GatewayPool) {
    Set gw = ##class(%Net.Remote.Gateway).%New()
    Set gw.Server = "localhost"
    Set gw.Port = 55555
    Set sc = gw.Connect()
    If $$$ISERR(sc) {
      Throw ##class(%Exception.StatusException).CreateFromStatus(sc)
    }
    Set ^%GatewayPool = gw
  }
  Return ^%GatewayPool
}

// تنظيف الموارد عند الانتهاء
ClassMethod Cleanup() {
  If $Data(^%GatewayPool) {
    Do ^%GatewayPool.Disconnect()
    Kill ^%GatewayPool
  }
}

نصائح مهمة

• إدارة الاتصالات: أعد استخدام الاتصالات بدلاً من إنشاء اتصال جديد لكل طلب
• معالجة الأخطاء: تعامل مع أخطاء الشبكة والاتصال بشكل استباقي
• تنظيف الموارد: أغلق الاتصالات عند الانتهاء لمنع تسرب الذاكرة
• التوافق: تأكد من توافق إصدارات Java/.NET مع إصدار IRIS
• الأمان: لا تنقل بيانات حساسة عبر Gateways بدون تشفير