/*- * ============LICENSE_START======================================================= * Copyright (C) 2021, 2023-2024 Nordix Foundation. * Modifications Copyright (C) 2022 Bell Canada. All rights reserved. * ================================================================================ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * SPDX-License-Identifier: Apache-2.0 * ============LICENSE_END========================================================= */ package org.onap.policy.models.dao.impl; import jakarta.persistence.EntityManager; import jakarta.persistence.Persistence; import jakarta.persistence.TypedQuery; import java.util.Collection; import java.util.Collections; import java.util.List; import lombok.RequiredArgsConstructor; import org.apache.commons.lang3.StringUtils; import org.onap.policy.models.base.PfConcept; import org.onap.policy.models.base.PfConceptKey; import org.onap.policy.models.base.PfModelException; import org.onap.policy.models.base.PfReferenceKey; import org.onap.policy.models.base.PfReferenceTimestampKey; import org.onap.policy.models.base.PfTimestampKey; import org.onap.policy.models.base.PfUtils; import org.onap.policy.models.dao.DaoParameters; import org.onap.policy.models.dao.PfDao; import org.onap.policy.models.dao.PfFilter; import org.onap.policy.models.dao.PfFilterFactory; import org.onap.policy.models.dao.PfFilterParametersIntfc; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * The Class ProxyDao is an JPA implementation of the {@link ProxyDao} class for Policy Framework concepts * ({@link PfConcept}). It uses the default JPA implementation in the jakarta {@link Persistence} class. */ @RequiredArgsConstructor public class ProxyDao implements PfDao { private static final Logger LOGGER = LoggerFactory.getLogger(ProxyDao.class); // @formatter:on // Entity manager for JPA private final EntityManager mg; @Override public void init(final DaoParameters daoParameters) throws PfModelException { // Entity manager for JPA should be created at Service level } @Override public final void close() { // Entity manager for JPA should be close at Service level } @Override public void create(final T obj) { if (obj == null) { return; } mg.merge(obj); mg.flush(); } @Override public void delete(final T obj) { if (obj == null) { return; } mg.remove(mg.contains(obj) ? obj : mg.merge(obj)); } @Override public void delete(final Class someClass, final PfConceptKey key) { if (key == null) { return; } // @formatter:off mg.createQuery(setQueryTable(DELETE_BY_CONCEPT_KEY, someClass), someClass) .setParameter(NAME, key.getName()) .setParameter(VERSION, key.getVersion()) .executeUpdate(); // @formatter:on } @Override public void delete(final Class someClass, final PfReferenceKey key) { if (key == null) { return; } // @formatter:off mg.createQuery(setQueryTable(DELETE_BY_REFERENCE_KEY, someClass), someClass) .setParameter(PARENT_NAME, key.getParentKeyName()) .setParameter(PARENT_VERSION, key.getParentKeyVersion()) .setParameter(LOCAL_NAME, key.getLocalName()) .executeUpdate(); // @formatter:on } @Override public void delete(final Class someClass, final PfTimestampKey key) { if (key == null) { return; } // @formatter:off mg.createQuery(setQueryTable(DELETE_BY_TIMESTAMP_KEY, someClass), someClass) .setParameter(NAME, key.getName()) .setParameter(VERSION, key.getVersion()) .setParameter(TIMESTAMP, key.getTimeStamp()) .executeUpdate(); // @formatter:on } @Override public void createCollection(final Collection objs) { if (objs == null || objs.isEmpty()) { return; } for (final T t : objs) { mg.merge(t); } } @Override public void deleteCollection(final Collection objs) { if (objs == null || objs.isEmpty()) { return; } for (final T t : objs) { mg.remove(mg.contains(t) ? t : mg.merge(t)); } } @Override public int deleteByConceptKey(final Class someClass, final Collection keys) { if (keys == null || keys.isEmpty()) { return 0; } var deletedCount = 0; for (final PfConceptKey key : keys) { // @formatter:off deletedCount += mg.createQuery(setQueryTable(DELETE_BY_CONCEPT_KEY, someClass), someClass) .setParameter(NAME, key.getName()) .setParameter(VERSION, key.getVersion()) .executeUpdate(); // @formatter:on } return deletedCount; } @Override public int deleteByReferenceKey(final Class someClass, final Collection keys) { if (keys == null || keys.isEmpty()) { return 0; } var deletedCount = 0; for (final PfReferenceKey key : keys) { // @formatter:off deletedCount += mg.createQuery(setQueryTable(DELETE_BY_REFERENCE_KEY, someClass), someClass) .setParameter(PARENT_NAME, key.getParentKeyName()) .setParameter(PARENT_VERSION, key.getParentKeyVersion()) .setParameter(LOCAL_NAME, key.getLocalName()) .executeUpdate(); // @formatter:on } return deletedCount; } @Override public void deleteAll(final Class someClass) { mg.createQuery(setQueryTable(DELETE_FROM_TABLE, someClass), someClass).executeUpdate(); } @Override public List getFiltered(final Class someClass, final String name, final String version) { if (name == null) { return getAll(someClass); } if (version == null) { return getAllVersions(someClass, name); } var foundConcept = get(someClass, new PfConceptKey(name, version)); return (foundConcept == null ? Collections.emptyList() : Collections.singletonList(foundConcept)); } @Override public List getFiltered(final Class someClass, PfFilterParametersIntfc filterParams) { PfFilter filter = new PfFilterFactory().createFilter(someClass); var filterQueryString = SELECT_FROM_TABLE + filter.genWhereClause(filterParams) + filter.genOrderClause(filterParams); TypedQuery query = mg.createQuery(setQueryTable(filterQueryString, someClass), someClass); filter.setParams(query, filterParams); LOGGER.debug("filterQueryString is \"{}\"", filterQueryString); return query.getResultList(); } @Override public T get(final Class someClass, final PfConceptKey key) { return genericGet(someClass, key); } @Override public T get(final Class someClass, final PfReferenceKey key) { return genericGet(someClass, key); } @Override public T get(final Class someClass, final PfTimestampKey key) { return genericGet(someClass, key); } @Override public T get(final Class someClass, final PfReferenceTimestampKey key) { return genericGet(someClass, key); } private T genericGet(final Class someClass, final Object key) { if (someClass == null) { return null; } final var t = mg.find(someClass, key); return checkAndReturn(someClass, t); } @Override public List getAll(final Class someClass) { if (someClass == null) { return Collections.emptyList(); } return mg.createQuery(setQueryTable(SELECT_FROM_TABLE, someClass), someClass).getResultList(); } @Override public List getAll(final Class someClass, final PfConceptKey parentKey) { if (someClass == null) { return Collections.emptyList(); } // @formatter:off return mg.createQuery(setQueryTable(SELECT_ALL_FOR_PARENT, someClass), someClass) .setParameter(PARENT_NAME, parentKey.getName()) .setParameter(PARENT_VERSION, parentKey.getVersion()) .getResultList(); // @formatter:on } @Override public List getAll(Class someClass, String orderBy, Integer numRecords) { if (someClass == null) { return Collections.emptyList(); } String query = setQueryTable(SELECT_FROM_TABLE, someClass); if (StringUtils.isNotBlank(orderBy)) { query = query.concat(ORDER_BY).concat(orderBy); } return mg.createQuery(query, someClass).setMaxResults(numRecords).getResultList(); } @Override public List getAllVersionsByParent(final Class someClass, final String parentKeyName) { if (someClass == null || parentKeyName == null) { return Collections.emptyList(); } // @formatter:off return mg.createQuery(setQueryTable(SELECT_ALL_VERSIONS_FOR_PARENT, someClass), someClass) .setParameter(PARENT_NAME, parentKeyName) .getResultList(); // @formatter:on } @Override public List getAllVersions(final Class someClass, final String conceptName) { if (someClass == null || conceptName == null) { return Collections.emptyList(); } // @formatter:off return mg.createQuery(setQueryTable(SELECT_ALL_VERSIONS, someClass), someClass) .setParameter(NAME, conceptName) .getResultList(); // @formatter:on } @Override public T getConcept(final Class someClass, final PfConceptKey key) { if (someClass == null || key == null) { return null; } // @formatter:off var ret = mg.createQuery(setQueryTable(SELECT_BY_CONCEPT_KEY, someClass), someClass) .setParameter(NAME, key.getName()) .setParameter(VERSION, key.getVersion()) .getResultList(); // @formatter:on return getSingleResult(someClass, key.getId(), ret); } @Override public T getConcept(final Class someClass, final PfReferenceKey key) { if (someClass == null || key == null) { return null; } // @formatter:off var ret = mg.createQuery(setQueryTable(SELECT_BY_REFERENCE_KEY, someClass), someClass) .setParameter(PARENT_NAME, key.getParentKeyName()) .setParameter(PARENT_VERSION, key.getParentKeyVersion()) .setParameter(LOCAL_NAME, key.getLocalName()) .getResultList(); // @formatter:on return getSingleResult(someClass, key.getId(), ret); } @Override public T update(final T obj) { var ret = mg.merge(obj); mg.flush(); return ret; } @Override public long size(final Class someClass) { if (someClass == null) { return 0; } long size = 0; /* * The invoking code only passes well-known classes into this method, thus * disabling the sonar about SQL injection. */ size = mg.createQuery("SELECT COUNT(c) FROM " + someClass.getSimpleName() + " c", Long.class) // NOSONAR .getSingleResult(); return size; } /** * Add the table to a query string. * * @param queryString the query string * @param tableClass the class name of the table * @return the updated query string */ private String setQueryTable(final String queryString, final Class tableClass) { return queryString.replace(TABLE_TOKEN, tableClass.getSimpleName()); } /** * Check that a query returned one and only one entry and return that entry. * * @param someClass the class being searched for * @param searchFilter the search filter * @param resultList the result list returned by the query * @return the single unique result */ private T getSingleResult(final Class someClass, final String searchFilter, List resultList) { if (resultList == null || resultList.isEmpty()) { return null; } if (resultList.size() > 1) { throw new IllegalArgumentException("More than one result was returned query on " + someClass + " with filter " + searchFilter + ": " + resultList); } return resultList.get(0); } /** * check the result get from database and return the object. * * @param the type of the object to get, a subclass of {@link PfConcept} * @param someClass the class of the object to get, a subclass of {@link PfConcept} * @param objToCheck the object that was retrieved from the database * @return the checked object or null */ private T checkAndReturn(final Class someClass, final T objToCheck) { if (objToCheck != null) { try { return PfUtils.makeCopy(objToCheck); } catch (final Exception e) { LOGGER.warn(CLONE_ERR_MSG, someClass.getName(), e); } } return null; } }