ee.datel.client.rr.RR404IsikV2Service Maven / Gradle / Ivy

Go to download
package ee.datel.client.rr;

/*-
 * ==========================LICENSE_START===================================
 * ee.datel.xtee6:xtee6-client-rr
 *  
 * Copyright (C) 2018 - 2024 AS Datel 
 *  
 * Redistribution and use in binary form, without modification, are permitted
 * provided that the following conditions are met:
 *
 * 1. Redistributions must reproduce the above copyright notice, this list of
 * conditions and the following disclaimer in the documentation and/or other
 * materials provided with the distribution.
 *
 * 2. Neither the name of the copyright holder nor the names of its
 * contributors may be used to endorse or promote products derived from this
 * software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * ===========================LICENSE_END====================================
 */

import ee.datel.client.utils.ServiceUtils;
import ee.datel.xtee.fault.ServiceFaultException;
import ee.xtee6.rr.rr404v2.Client;
import ee.xtee6.rr.rr404v2.RR404IsikRequestType;
import ee.xtee6.rr.rr404v2.RR404IsikResponseType;
import ee.xtee6.rr.rr404v2.RR404IsikResponseType.TtIsikud404.Item;
import ee.xtee6.rr.rr404v2.Service;
import ee.xtee6.rr.rr404v2.XRoadAdapterPortType;
import ee.xtee6.rr.rr404v2.XRoadService;

import java.util.Collections;
import java.util.List;

import jakarta.xml.ws.WebServiceException;

public class RR404IsikV2Service extends RrCommon {

    private static XRoadService srv = new XRoadService();

    private RR404IsikV2Service() {}

    /**
     *
     * @param params parameetrid
     * @param userid kasutaja isikukood
     * @param isikukoodid päritav isikukood
     * @param valjad andmeväljad
     *
     *             * 1 – põhiandmed: isikukood, perekonnanimi, eesnimi (eraldi väljad, aga järjekord sama)
     * 2 – muud nimed: perekonnanimed, muud eesnimed (eraldi väljad)
     * 3 – kodakondsus: riigi kood, nimetus (eraldi väljad)
     * 4 – isanimi
     * 6 – sugu ja sünniaeg (eraldi väljadel)
     * 7 – surma kuupäev
     * 8 – teovõime
     * 9 – isiku staatus (staatuse kood)
     * 10 – isiku kirje staatus (staatuse kood)
     *
     * 20 – elukoha tüüp – kood ja tekst
     * 21 -  elukoha riik - kood ja tekst
     * 22 – elukoha maakond – kood ja tekst (Eesti aadressi korral, EHAKi kood)
     * 23 – elukoha vald – kood ja tekst (Eesti aadressi korral, EHAKi kood)
     * 24 -  elukoha asula – kood ja tekst (Eesti aadressi korral, EHAKi kood)
     * 25 -  elukoha tänav , maja nr, korter (eraldi väljad, kõik tekstina)
     * 26 – elukoha postiindeks (tekst)
     * 27 – elukoha alguse kuupäev
     * 28 – elukoha valla alguse kuupäev
     * 29 – sideandmed (ruumi sideaadress, telefon, e-post, muu)
     * 30 -  aadress (leitud isiku aadress ühe stringina: elukoha (aadressi) maakonna tekst
     *      + elukoha (aadressi) valla tekst
     *      + elukoha (aadressi)asula tekst + elukoha (aadressi) tänava nimi
     *      + elukoha (aadressi) maja number + elukoha (aadressi) korteri number (kui tegemist on Eesti elukohaga/aadressiga)
     *          – tasemed on komaga eraldatud. Aadress esitatakse nii eesti- kui ka välismaa aadressi puhul)
     *        
     *
     * @param issue põhjus
     * @return nimekiri
     * @throws ServiceFaultException soap viga
     */
    @SuppressWarnings("unchecked")
    public static List getRR404Isik(RR404IsikXRoadParams params, String userid, String isikukoodid, String valjad,
            String issue) throws ServiceFaultException {
        RR404IsikRequestType request = new RR404IsikRequestType();
        request.setCIsikukoodid(isikukoodid);
        request.setCValjad(valjad);
        var id = ServiceUtils.getRequestId();
        try {
            RR404IsikResponseType result = params.getPort().rr404Isik(request, params.getClient(), params.getService(),
                    userid, id, issue, ServiceUtils.getProtocolVersion());
            if (result.getFaultCode() != null) {
                if ("10001".equals(result.getFaultCode())// 10001: Isikukoodi pikkus ei ole 11 sümbolit
                        || "10005".equals(result.getFaultCode()) // Isikukoodi kontrolljärk on vale
                        || "10010".equals(result.getFaultCode()) // Päring ei saanud vastust. Andmed puuduvad
                        || "10027".equals(result.getFaultCode()) // Isik puudub RRis
                ) {
                    return Collections.emptyList();
                }
                throw new ServiceFaultException(result.getFaultCode(), result.getFaultString(), id);
            }
            return (List) (result.getTtIsikud404() == null ? Collections.emptyList()
                    : result.getTtIsikud404().getItems());
        } catch (WebServiceException ex) {
            throw new ServiceFaultException(ex.getClass().getSimpleName(), ex.getMessage(), id);
        }
    }

    protected static Service getServiceIdentifier(String xroadInstance) {
        return getServiceIdentifier(xroadInstance, memberClass, serviceCode, subsystemCode, "RR404_isik", "v2");
    }

    protected static XRoadAdapterPortType getServicePort(String serverUrl) {
        XRoadAdapterPortType port = srv.getMainPort();
        ServiceUtils.connectPort(port, serverUrl);
        return port;
    }

    protected static Client getClientIdentifier(String xroadInstance, String memberClass, String memberCode,
            String subsystemCode) {
        var client = new Client();
        ServiceUtils.getXRoadIdentifierType(client, xroadInstance, memberClass, memberCode, subsystemCode);
        return client;
    }

    protected static Service getServiceIdentifier(String xroadInstance, String memberClass, String memberCode,
            String subsystemCode, String serviceCode, String serviceVersion) {
        var server = new Service();
        ServiceUtils.getXRoadIdentifierType(server, xroadInstance, memberClass, memberCode, subsystemCode, serviceCode,
                serviceVersion);
        return server;
    }

    public static class RR404IsikXRoadParams {
        private XRoadAdapterPortType port;
        private Client client;
        private Service service;

        public RR404IsikXRoadParams(String serverUrl, String xRoadInstance, String memberClass, String memberCode,
                String subsystemCode) {
            port = getServicePort(serverUrl);
            client = getClientIdentifier(xRoadInstance, memberClass, memberCode, subsystemCode);
            service = getServiceIdentifier(xRoadInstance);
        }

        public Service getService() {
            return service;
        }

        public Client getClient() {
            return client;
        }

        public XRoadAdapterPortType getPort() {
            return port;
        }
    }
}