001package ca.uhn.fhir.mdm.rules.matcher;
002
003/*-
004 * #%L
005 * HAPI FHIR - Master Data Management
006 * %%
007 * Copyright (C) 2014 - 2022 Smile CDR, Inc.
008 * %%
009 * Licensed under the Apache License, Version 2.0 (the "License");
010 * you may not use this file except in compliance with the License.
011 * You may obtain a copy of the License at
012 *
013 *      http://www.apache.org/licenses/LICENSE-2.0
014 *
015 * Unless required by applicable law or agreed to in writing, software
016 * distributed under the License is distributed on an "AS IS" BASIS,
017 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
018 * See the License for the specific language governing permissions and
019 * limitations under the License.
020 * #L%
021 */
022
023import ca.uhn.fhir.context.FhirContext;
024import ca.uhn.fhir.mdm.util.NameUtil;
025import ca.uhn.fhir.util.StringUtil;
026import org.apache.commons.lang3.StringUtils;
027import org.hl7.fhir.instance.model.api.IBase;
028
029import java.util.List;
030import java.util.stream.Collectors;
031
032/**
033 * Similarity measure for two IBase name fields
034 */
035public class NameMatcher implements IMdmFieldMatcher {
036
037        private final MdmNameMatchModeEnum myMatchMode;
038
039        public NameMatcher(MdmNameMatchModeEnum theMatchMode) {
040                myMatchMode = theMatchMode;
041        }
042
043        @Override
044        public boolean matches(FhirContext theFhirContext, IBase theLeftBase, IBase theRightBase, boolean theExact, String theIdentifierSystem) {
045                String leftFamilyName = NameUtil.extractFamilyName(theFhirContext, theLeftBase);
046                String rightFamilyName = NameUtil.extractFamilyName(theFhirContext, theRightBase);
047                if (StringUtils.isEmpty(leftFamilyName) || StringUtils.isEmpty(rightFamilyName)) {
048                        return false;
049                }
050
051                boolean match = false;
052
053                List<String> leftGivenNames = NameUtil.extractGivenNames(theFhirContext, theLeftBase);
054                List<String> rightGivenNames = NameUtil.extractGivenNames(theFhirContext, theRightBase);
055
056                if (!theExact) {
057                        leftFamilyName = StringUtil.normalizeStringForSearchIndexing(leftFamilyName);
058                        rightFamilyName = StringUtil.normalizeStringForSearchIndexing(rightFamilyName);
059                        leftGivenNames = leftGivenNames.stream().map(StringUtil::normalizeStringForSearchIndexing).collect(Collectors.toList());
060                        rightGivenNames = rightGivenNames.stream().map(StringUtil::normalizeStringForSearchIndexing).collect(Collectors.toList());
061                }
062
063                for (String leftGivenName : leftGivenNames) {
064                        for (String rightGivenName : rightGivenNames) {
065                                match |= leftGivenName.equals(rightGivenName) && leftFamilyName.equals(rightFamilyName);
066                                if (myMatchMode == MdmNameMatchModeEnum.ANY_ORDER) {
067                                        match |= leftGivenName.equals(rightFamilyName) && leftFamilyName.equals(rightGivenName);
068                                }
069                        }
070                }
071
072                return match;
073        }
074}