• Home
• win.doyto
• doyto-query-web
• 2.1.0
• source code
• DynamicService.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

win.doyto.query.service.DynamicService Maven / Gradle / Ivy

/*
 * Copyright © 2019-2024 Forb Yuan
 *
 * 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.
 */

package win.doyto.query.service;

import win.doyto.query.core.DoytoQuery;
import win.doyto.query.core.IdWrapper;
import win.doyto.query.entity.Persistable;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
 * DynamicService
 *
 * @author f0rb on 2019-06-01
 */
public interface DynamicService, I extends Serializable, Q extends DoytoQuery> extends QueryService {

    List queryIds(Q query);

     List queryColumns(Q query, Class clazz, String... columns);

    void create(E e);

    int update(E e);

    default E save(E e) {
        if (isNewEntity(e)) {
            create(e);
        } else {
            update(e);
        }
        return e;
    }

    default boolean isNewEntity(E e) {
        return e.isNew();
    }

    int patch(E e);

    /**
     * 执行INSERT INTO [TABLE] (col1, col2) VALUES (?), (?)
     * 

     * 
会清空全部缓存
     * 
不会按id清理缓存
     * 
不会执行{@link win.doyto.query.entity.EntityAspect#afterCreate(Object)}
     * 
     *
     * @param entities entities to insert
     * @param columns  update columns on duplicate
     * @return amount of updated entities
     */
    int create(Collection entities, String... columns);

    /**
     * 执行UPDATE [TABLE] SET ... WHERE ...
     * 

     * 
会清空全部缓存
     * 
不会按id清理缓存
     * 
不会执行{@link win.doyto.query.entity.EntityAspect#afterUpdate(Object, Object)}
     * 
     *
     * @param e entity object
     * @param q query object
     * @return amount of updated entities
     */
    int patch(E e, Q q);


    /**
     * 执行DELETE FORM [TABLE] WHERE ...
     * 

     * 
会清空全部缓存
     * 
不会按id清理缓存
     * 
不会执行{@link win.doyto.query.entity.EntityAspect#afterDelete(Object)}
     * 
     *
     * @param q query object
     * @return amount of updated entities
     */
    int delete(Q q);

    /**
     * Get origin entity from sharding table
     *
     * @param w an entity just contains id and information of sharding table
     * @return origin entity
     */
    E get(IdWrapper w);

    /**
     * force to get a new entity object from database
     *
     * @param w entity id
     * @return a new entity object
     */
    E fetch(IdWrapper w);

    /**
     * Delete entity from sharding table
     *
     * @param w an entity just contains id and information of sharding table
     * @return origin entity
     */
    E remove(IdWrapper w);

}