HTTP aracılığıyla Uzak API
Kendi sitenizden operatörler oluşturmak ve NxCloud DB'yi otomatik olarak güncellemek isteyebilirsiniz. Aşağıdakiler için kendi API setinizi oluşturabilirsiniz
NxCloud'un DAO ve Data sınıflarını kullanarak operatörlerinizle uzaktan ilgilenme.
DAO ve Data sınıfları hakkında daha fazla bilgi için DAO ve Veri sınıfları
Örnek API seti
/nxfilter/webapps/example/remoteapi.jsp içinde örnek bir API setimiz var. Bu JSP sayfasını HTTP protokolü aracılığıyla uzaktan çağırabilirsiniz.
JSP sayfasında bu eylemler tanımlanmıştır,
- createOperator
Bu eylem ile bir operatör oluşturabilirsiniz. 2 parametre alır.
Bir operatör adı için 'opName'. Diğeri ise oluşturmak istediğiniz operatörün türü için 'opType',
iş türü operatörü için 1'i ve ev türü operatörü için 2'yi ayarlayın. Başarı durumunda '/OK' ve hata durumunda '/ERR' döndürür.
ex) http://localhost/example/remoteapi.jsp?action=createOperator&opName=testname&opType=1
- selectOperator
Bu eylem ile bir operatörün bilgilerini getirebilirsiniz. Bir operatör adı için 'opName' parametresini alır.
Başarı durumunda, operatörün bilgilerini içeren bir JSON dizisi döndürür.
Hata durumunda '/ERR' döndürür.
ex) http://localhost/example/remoteapi.jsp?action=selectOperator&opName=testname
- setExpDate
Bu, bir operatör için bir son kullanma tarihi ayarlamak içindir. 2 parametre alır.
Biri operatör adı için 'opName'. Diğeri ise 'expDate' olup son kullanma tarihi için 'yyyyMMdd' formatında bir dizedir.
filtreleme hizmeti için ayarlamak istediğiniz tarih. Başarı durumunda '/OK' ve hata durumunda '/ERR' döndürür.
ex) http://localhost/example/remoteapi.jsp?action=setExpDate&opName=testname&expDate=20191231
Varsayılan olarak, örnek JSP sayfası yalnızca 127.0.0.1 veya localhost'tan gelen çağrıları kabul eder. JPS sayfasının kısıtlama bölümünü aşağıdakileri kabul edecek şekilde değiştirmeniz gerekir diğer ana bilgisayarlardan gelen istekler.
// Only localhost access allowed.
if(!request.getRemoteAddr().startsWith("127.0.0.1")){
out.println(request.getRemoteAddr());
return;
}
Bu uzak API işlevlerini yapmak için yalnızca NxFilter DAO ve Data sınıflarını kullandık. Bu yüzden daha da karmaşık olanları inşa etmeniz mümkündür.
JSP sayfalarınız için IP tabanlı bir ACL'ye şu şekilde sahip olabilirsiniz System > Allowed IP > Allowed IP To GUI.