com.github.lontime.shaded.org.redisson.api.RGeoAsync Maven / Gradle / Ivy
/**
* Copyright (c) 2013-2021 Nikita Koksharov
*
* 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 com.github.lontime.shaded.org.redisson.api;
import com.github.lontime.shaded.org.redisson.api.geo.GeoSearchArgs;
import java.util.List;
import java.util.Map;
/**
* Geospatial items holder. Asynchronous interface.
*
* @author Nikita Koksharov
*
* @param type of value
*/
public interface RGeoAsync extends RScoredSortedSetAsync {
/**
* Adds geospatial member.
*
* @param longitude - longitude of object
* @param latitude - latitude of object
* @param member - object itself
* @return number of elements added to the sorted set,
* not including elements already existing for which
* the score was updated
*/
RFuture addAsync(double longitude, double latitude, V member);
/**
* Adds geospatial members.
*
* @param entries - objects
* @return number of elements added to the sorted set,
* not including elements already existing for which
* the score was updated
*/
RFuture addAsync(GeoEntry... entries);
/**
* Adds geospatial member only if it's already exists.
*
* Requires Redis 6.2.0 and higher.
*
* @param longitude - longitude of object
* @param latitude - latitude of object
* @param member - object itself
* @return number of elements added to the sorted set
*/
RFuture addIfExistsAsync(double longitude, double latitude, V member);
/**
* Adds geospatial members only if it's already exists.
*
* Requires Redis 6.2.0 and higher.
*
* @param entries - objects
* @return number of elements added to the sorted set
*/
RFuture addIfExistsAsync(GeoEntry... entries);
/**
* Adds geospatial member only if has not been added before.
*
* Requires Redis 6.2.0 and higher.
*
* @param longitude - longitude of object
* @param latitude - latitude of object
* @param member - object itself
* @return number of elements added to the sorted set
*/
RFuture tryAddAsync(double longitude, double latitude, V member);
/**
* Adds geospatial members only if has not been added before.
*
* Requires Redis 6.2.0 and higher.
*
* @param entries - objects
* @return number of elements added to the sorted set
*/
RFuture tryAddAsync(GeoEntry... entries);
/**
* Returns distance between members in GeoUnit units.
*
* @param firstMember - first object
* @param secondMember - second object
* @param geoUnit - geo unit
* @return distance
*/
RFuture distAsync(V firstMember, V secondMember, GeoUnit geoUnit);
/**
* Returns 11 characters Geohash string mapped by defined member.
*
* @param members - objects
* @return hash mapped by object
*/
RFuture> hashAsync(V... members);
/**
* Returns geo-position mapped by defined member.
*
* @param members - objects
* @return geo position mapped by object
*/
RFuture> posAsync(V... members);
/**
* Returns the members of a sorted set, which are within the
* borders of specified search conditions.
*
* Usage examples:
*
* RFuture objects = geo.searchAsync(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)
* .order(GeoOrder.ASC)
* .count(1)));
*
*
* RFuture objects = geo.searchAsync(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)));
*
*
* Requires Redis 3.2.10 and higher.
*
* @param args - search conditions object
* @return list of memebers
*/
RFuture> searchAsync(GeoSearchArgs args);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(double longitude, double latitude, double radius, GeoUnit geoUnit);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, int count);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/**
* Returns the distance mapped by member of a sorted set,
* which are within the borders of specified search conditions.
*
* Usage examples:
*
* RFuture objects = geo.searchWithDistanceAsync(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)
* .order(GeoOrder.ASC)
* .count(1)));
*
*
* RFuture objects = geo.searchWithDistanceAsync(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)));
*
*
* Requires Redis 3.2.10 and higher.
*
* @param args - search conditions object
* @return distance mapped by object
*/
RFuture> searchWithDistanceAsync(GeoSearchArgs args);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(double longitude, double latitude, double radius, GeoUnit geoUnit);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, int count);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/**
* Returns the position mapped by member of a sorted set,
* which are within the borders of specified search conditions.
*
* Usage examples:
*
* List objects = geo.searchWithPosition(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)
* .order(GeoOrder.ASC)
* .count(1)));
*
*
* List objects = geo.searchWithPosition(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)));
*
*
* Requires Redis 3.2.10 and higher.
*
* @param args - search conditions object
* @return position mapped by object
*/
RFuture> searchWithPositionAsync(GeoSearchArgs args);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(double longitude, double latitude, double radius, GeoUnit geoUnit);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, int count);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(V member, double radius, GeoUnit geoUnit);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(V member, double radius, GeoUnit geoUnit, int count);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchAsync() method instead
*
*/
@Deprecated
RFuture> radiusAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(V member, double radius, GeoUnit geoUnit);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(V member, double radius, GeoUnit geoUnit, int count);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchWithDistanceAsync() method instead
*
*/
RFuture> radiusWithDistanceAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(V member, double radius, GeoUnit geoUnit);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(V member, double radius, GeoUnit geoUnit, int count);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder);
/*
* Use searchWithPositionAsync() method instead
*
*/
RFuture> radiusWithPositionAsync(V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/**
* Finds the members of a sorted set,
* which are within the borders of specified search conditions.
*
* Stores result to destName.
*
* Usage examples:
*
* long count = geo.storeSearchTo(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)
* .order(GeoOrder.ASC)
* .count(1)));
*
*
* long count = geo.storeSearchTo(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)));
*
*
* @param args - search conditions object
* @return length of result
*/
RFuture storeSearchToAsync(String destName, GeoSearchArgs args);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit, int count);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, V member, double radius, GeoUnit geoUnit);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, V member, double radius, GeoUnit geoUnit, int count);
/*
* Use storeSearchToAsync() method instead
*
*/
@Deprecated
RFuture radiusStoreToAsync(String destName, V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/**
* Finds the members of a sorted set,
* which are within the borders of specified search conditions.
*
* Stores result to destName sorted by distance.
*
* Usage examples:
*
* long count = geo.storeSortedSearchTo(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)
* .order(GeoOrder.ASC)
* .count(1)));
*
*
* long count = geo.storeSortedSearchTo(GeoSearchArgs.from(15, 37)
* .radius(200, GeoUnit.KILOMETERS)));
*
*
* @param args - search conditions object
* @return length of result
*/
RFuture storeSortedSearchToAsync(String destName, GeoSearchArgs args);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit, int count);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, double longitude, double latitude, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, V member, double radius, GeoUnit geoUnit);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, V member, double radius, GeoUnit geoUnit, int count);
/*
* Use storeSortedSearchToAsync() method instead
*
*/
RFuture radiusStoreSortedToAsync(String destName, V member, double radius, GeoUnit geoUnit, GeoOrder geoOrder, int count);
}