001 /** 002 * Copyright (c) 2000-2013 Liferay, Inc. All rights reserved. 003 * 004 * This library is free software; you can redistribute it and/or modify it under 005 * the terms of the GNU Lesser General Public License as published by the Free 006 * Software Foundation; either version 2.1 of the License, or (at your option) 007 * any later version. 008 * 009 * This library is distributed in the hope that it will be useful, but WITHOUT 010 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 011 * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more 012 * details. 013 */ 014 015 package com.liferay.portal.service.http; 016 017 import com.liferay.portal.kernel.log.Log; 018 import com.liferay.portal.kernel.log.LogFactoryUtil; 019 import com.liferay.portal.service.ContactServiceUtil; 020 021 import java.rmi.RemoteException; 022 023 /** 024 * Provides the SOAP utility for the 025 * {@link com.liferay.portal.service.ContactServiceUtil} service utility. The 026 * static methods of this class calls the same methods of the service utility. 027 * However, the signatures are different because it is difficult for SOAP to 028 * support certain types. 029 * 030 * <p> 031 * ServiceBuilder follows certain rules in translating the methods. For example, 032 * if the method in the service utility returns a {@link java.util.List}, that 033 * is translated to an array of {@link com.liferay.portal.model.ContactSoap}. 034 * If the method in the service utility returns a 035 * {@link com.liferay.portal.model.Contact}, that is translated to a 036 * {@link com.liferay.portal.model.ContactSoap}. Methods that SOAP cannot 037 * safely wire are skipped. 038 * </p> 039 * 040 * <p> 041 * The benefits of using the SOAP utility is that it is cross platform 042 * compatible. SOAP allows different languages like Java, .NET, C++, PHP, and 043 * even Perl, to call the generated services. One drawback of SOAP is that it is 044 * slow because it needs to serialize all calls into a text format (XML). 045 * </p> 046 * 047 * <p> 048 * You can see a list of services at http://localhost:8080/api/axis. Set the 049 * property <b>axis.servlet.hosts.allowed</b> in portal.properties to configure 050 * security. 051 * </p> 052 * 053 * <p> 054 * The SOAP utility is only generated for remote services. 055 * </p> 056 * 057 * @author Brian Wing Shun Chan 058 * @see ContactServiceHttp 059 * @see com.liferay.portal.model.ContactSoap 060 * @see com.liferay.portal.service.ContactServiceUtil 061 * @generated 062 */ 063 public class ContactServiceSoap { 064 public static com.liferay.portal.model.ContactSoap getContact( 065 long contactId) throws RemoteException { 066 try { 067 com.liferay.portal.model.Contact returnValue = ContactServiceUtil.getContact(contactId); 068 069 return com.liferay.portal.model.ContactSoap.toSoapModel(returnValue); 070 } 071 catch (Exception e) { 072 _log.error(e, e); 073 074 throw new RemoteException(e.getMessage()); 075 } 076 } 077 078 public static com.liferay.portal.model.ContactSoap[] getContacts( 079 long classNameId, long classPK, int start, int end, 080 com.liferay.portal.kernel.util.OrderByComparator orderByComparator) 081 throws RemoteException { 082 try { 083 java.util.List<com.liferay.portal.model.Contact> returnValue = ContactServiceUtil.getContacts(classNameId, 084 classPK, start, end, orderByComparator); 085 086 return com.liferay.portal.model.ContactSoap.toSoapModels(returnValue); 087 } 088 catch (Exception e) { 089 _log.error(e, e); 090 091 throw new RemoteException(e.getMessage()); 092 } 093 } 094 095 public static int getContactsCount(long classNameId, long classPK) 096 throws RemoteException { 097 try { 098 int returnValue = ContactServiceUtil.getContactsCount(classNameId, 099 classPK); 100 101 return returnValue; 102 } 103 catch (Exception e) { 104 _log.error(e, e); 105 106 throw new RemoteException(e.getMessage()); 107 } 108 } 109 110 private static Log _log = LogFactoryUtil.getLog(ContactServiceSoap.class); 111 }