X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=osm_common%2Fdbmongo.py;h=57ce08285211bd84c5267680742379d0e96ab77e;hb=c837a7819c5388b276ada7f29a085cd251119e4b;hp=41409d2dd27f323ff62a0d4f2c7a8e6faf8c61f4;hpb=6ec13b0ec457da355bf3b884201a0b4bab90cb3c;p=osm%2Fcommon.git diff --git a/osm_common/dbmongo.py b/osm_common/dbmongo.py index 41409d2..57ce082 100644 --- a/osm_common/dbmongo.py +++ b/osm_common/dbmongo.py @@ -1,3 +1,20 @@ +# -*- coding: utf-8 -*- + +# Copyright 2018 Telefonica S.A. +# +# 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. + import logging from pymongo import MongoClient, errors @@ -5,6 +22,7 @@ from osm_common.dbbase import DbException, DbBase from http import HTTPStatus from time import time, sleep from copy import deepcopy +from base64 import b64decode __author__ = "Alfonso Tierno " @@ -18,14 +36,15 @@ __author__ = "Alfonso Tierno " # return call(*args, **kwargs) # except pymongo.AutoReconnect as e: # if retry == 4: -# raise DbException(str(e)) +# raise DbException(e) # sleep(retry) # return _retry_mongocall def deep_update(to_update, update_with): """ - Update 'to_update' dict with the content 'update_with' dict recursively + Similar to deepcopy but recursively with nested dictionaries. 'to_update' dict is updated with a content copy of + 'update_with' dict recursively :param to_update: must be a dictionary to be modified :param update_with: must be a dictionary. It is not changed :return: to_update @@ -43,14 +62,30 @@ class DbMongo(DbBase): conn_initial_timout = 120 conn_timout = 10 - def __init__(self, logger_name='db'): - self.logger = logging.getLogger(logger_name) + def __init__(self, logger_name='db', lock=False): + super().__init__(logger_name, lock) + self.client = None + self.db = None - def db_connect(self, config): + def db_connect(self, config, target_version=None): + """ + Connect to database + :param config: Configuration of database + :param target_version: if provided it checks if database contains required version, raising exception otherwise. + :return: None or raises DbException on error + """ try: if "logger_name" in config: self.logger = logging.getLogger(config["logger_name"]) - self.client = MongoClient(config["host"], config["port"]) + master_key = config.get("commonkey") or config.get("masterpassword") + if master_key: + self.set_secret_key(master_key) + if config.get("uri"): + self.client = MongoClient(config["uri"]) + else: + self.client = MongoClient(config["host"], config["port"]) + # TODO add as parameters also username=config.get("user"), password=config.get("password")) + # when all modules are ready self.db = self.client[config["name"]] if "loglevel" in config: self.logger.setLevel(getattr(logging, config['loglevel'])) @@ -58,7 +93,19 @@ class DbMongo(DbBase): now = time() while True: try: - self.db.users.find_one({"username": "admin"}) + version_data = self.get_one("admin", {"_id": "version"}, fail_on_empty=False, fail_on_more=True) + # check database status is ok + if version_data and version_data.get("status") != 'ENABLED': + raise DbException("Wrong database status '{}'".format(version_data.get("status")), + http_code=HTTPStatus.INTERNAL_SERVER_ERROR) + # check version + db_version = None if not version_data else version_data.get("version") + if target_version and target_version != db_version: + raise DbException("Invalid database version {}. Expected {}".format(db_version, target_version)) + # get serial + if version_data and version_data.get("serial"): + self.set_secret_key(b64decode(version_data["serial"])) + self.logger.info("Connected to database {} version {}".format(config["name"], db_version)) return except errors.ConnectionFailure as e: if time() - now >= self.conn_initial_timout: @@ -66,27 +113,50 @@ class DbMongo(DbBase): self.logger.info("Waiting to database up {}".format(e)) sleep(2) except errors.PyMongoError as e: - raise DbException(str(e)) - - def db_disconnect(self): - pass # TODO + raise DbException(e) @staticmethod def _format_filter(q_filter): """ - Translate query string filter into mongo database filter + Translate query string q_filter into mongo database filter :param q_filter: Query string content. Follows SOL005 section 4.3.2 guidelines, with the follow extensions and - differences: It accpept ".nq" (not equal) in addition to ".neq". - For arrays if get an item with exact matching. For partial matching, use the special work ".ANYINDEX.". + differences: + It accept ".nq" (not equal) in addition to ".neq". + For arrays you can specify index (concrete index must match), nothing (any index may match) or 'ANYINDEX' + (two or more matches applies for the same array element). Examples: + with database register: {A: [{B: 1, C: 2}, {B: 6, C: 9}]} + query 'A.B=6' matches because array A contains one element with B equal to 6 + query 'A.0.B=6' does no match because index 0 of array A contains B with value 1, but not 6 + query 'A.B=6&A.C=2' matches because one element of array matches B=6 and other matchesC=2 + query 'A.ANYINDEX.B=6&A.ANYINDEX.C=2' does not match because it is needed the same element of the + array matching both + + Examples of translations from SOL005 to >> mongo # comment + A=B; A.eq=B >> A: B # must contain key A and equal to B or be a list that contains B + A.cont=B >> A: B + A=B&A=C; A=B,C >> A: {$in: [B, C]} # must contain key A and equal to B or C or be a list that contains + # B or C + A.cont=B&A.cont=C; A.cont=B,C >> A: {$in: [B, C]} + A.ncont=B >> A: {$nin: B} # must not contain key A or if present not equal to B or if a list, + # it must not not contain B + A.ncont=B,C; A.ncont=B&A.ncont=C >> A: {$nin: [B,C]} # must not contain key A or if present not equal + # neither B nor C; or if a list, it must not contain neither B nor C + A.ne=B&A.ne=C; A.ne=B,C >> A: {$nin: [B, C]} + A.gt=B >> A: {$gt: B} # must contain key A and greater than B + A.ne=B; A.neq=B >> A: {$ne: B} # must not contain key A or if present not equal to B, or if + # an array not contain B + A.ANYINDEX.B=C >> A: {$elemMatch: {B=C} :return: database mongo filter """ try: db_filter = {} + if not q_filter: + return db_filter for query_k, query_v in q_filter.items(): dot_index = query_k.rfind(".") if dot_index > 1 and query_k[dot_index+1:] in ("eq", "ne", "gt", "gte", "lt", "lte", "cont", "ncont", "neq"): - operator = "$" + query_k[dot_index+1:] + operator = "$" + query_k[dot_index + 1:] if operator == "$neq": operator = "$ne" k = query_k[:dot_index] @@ -114,7 +184,7 @@ class DbMongo(DbBase): else: db_v = {operator: v} - # process the ANYINDEX word at k + # process the ANYINDEX word at k. kleft, _, kright = k.rpartition(".ANYINDEX.") while kleft: k = kleft @@ -130,95 +200,170 @@ class DbMongo(DbBase): raise DbException("Invalid query string filter at {}:{}. Error: {}".format(query_k, v, e), http_code=HTTPStatus.BAD_REQUEST) - def get_list(self, table, filter={}): + def get_list(self, table, q_filter=None): + """ + Obtain a list of entries matching q_filter + :param table: collection or table + :param q_filter: Filter + :return: a list (can be empty) with the found entries. Raises DbException on error + """ try: - l = [] - collection = self.db[table] - db_filter = self._format_filter(filter) - rows = collection.find(db_filter) + result = [] + with self.lock: + collection = self.db[table] + db_filter = self._format_filter(q_filter) + rows = collection.find(db_filter) for row in rows: - l.append(row) - return l + result.append(row) + return result except DbException: raise except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) - def get_one(self, table, filter={}, fail_on_empty=True, fail_on_more=True): + def get_one(self, table, q_filter=None, fail_on_empty=True, fail_on_more=True): + """ + Obtain one entry matching q_filter + :param table: collection or table + :param q_filter: Filter + :param fail_on_empty: If nothing matches filter it returns None unless this flag is set tu True, in which case + it raises a DbException + :param fail_on_more: If more than one matches filter it returns one of then unless this flag is set tu True, so + that it raises a DbException + :return: The requested element, or None + """ try: - if filter: - filter = self._format_filter(filter) - collection = self.db[table] - if not (fail_on_empty and fail_on_more): - return collection.find_one(filter) - rows = collection.find(filter) + db_filter = self._format_filter(q_filter) + with self.lock: + collection = self.db[table] + if not (fail_on_empty and fail_on_more): + return collection.find_one(db_filter) + rows = collection.find(db_filter) if rows.count() == 0: if fail_on_empty: - raise DbException("Not found any {} with filter='{}'".format(table[:-1], filter), + raise DbException("Not found any {} with filter='{}'".format(table[:-1], q_filter), HTTPStatus.NOT_FOUND) return None elif rows.count() > 1: if fail_on_more: - raise DbException("Found more than one {} with filter='{}'".format(table[:-1], filter), + raise DbException("Found more than one {} with filter='{}'".format(table[:-1], q_filter), HTTPStatus.CONFLICT) return rows[0] except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) - def del_list(self, table, filter={}): + def del_list(self, table, q_filter=None): + """ + Deletes all entries that match q_filter + :param table: collection or table + :param q_filter: Filter + :return: Dict with the number of entries deleted + """ try: - collection = self.db[table] - rows = collection.delete_many(self._format_filter(filter)) + with self.lock: + collection = self.db[table] + rows = collection.delete_many(self._format_filter(q_filter)) return {"deleted": rows.deleted_count} except DbException: raise except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) - def del_one(self, table, filter={}, fail_on_empty=True): + def del_one(self, table, q_filter=None, fail_on_empty=True): + """ + Deletes one entry that matches q_filter + :param table: collection or table + :param q_filter: Filter + :param fail_on_empty: If nothing matches filter it returns '0' deleted unless this flag is set tu True, in + which case it raises a DbException + :return: Dict with the number of entries deleted + """ try: - collection = self.db[table] - rows = collection.delete_one(self._format_filter(filter)) + with self.lock: + collection = self.db[table] + rows = collection.delete_one(self._format_filter(q_filter)) if rows.deleted_count == 0: if fail_on_empty: - raise DbException("Not found any {} with filter='{}'".format(table[:-1], filter), + raise DbException("Not found any {} with filter='{}'".format(table[:-1], q_filter), HTTPStatus.NOT_FOUND) return None return {"deleted": rows.deleted_count} except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) def create(self, table, indata): + """ + Add a new entry at database + :param table: collection or table + :param indata: content to be added + :return: database id of the inserted element. Raises a DbException on error + """ try: - collection = self.db[table] - data = collection.insert_one(indata) + with self.lock: + collection = self.db[table] + data = collection.insert_one(indata) return data.inserted_id except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) - def set_one(self, table, filter, update_dict, fail_on_empty=True): + def set_one(self, table, q_filter, update_dict, fail_on_empty=True): + """ + Modifies an entry at database + :param table: collection or table + :param q_filter: Filter + :param update_dict: Plain dictionary with the content to be updated. It is a dot separated keys and a value + :param fail_on_empty: If nothing matches filter it returns None unless this flag is set tu True, in which case + it raises a DbException + :return: Dict with the number of entries modified. None if no matching is found. + """ try: - collection = self.db[table] - rows = collection.update_one(self._format_filter(filter), {"$set": update_dict}) + with self.lock: + collection = self.db[table] + rows = collection.update_one(self._format_filter(q_filter), {"$set": update_dict}) if rows.matched_count == 0: if fail_on_empty: - raise DbException("Not found any {} with filter='{}'".format(table[:-1], filter), + raise DbException("Not found any {} with filter='{}'".format(table[:-1], q_filter), HTTPStatus.NOT_FOUND) return None return {"modified": rows.modified_count} except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e) - def replace(self, table, id, indata, fail_on_empty=True): + def set_list(self, table, q_filter, update_dict): + """ + Modifies al matching entries at database + :param table: collection or table + :param q_filter: Filter + :param update_dict: Plain dictionary with the content to be updated. It is a dot separated keys and a value + :return: Dict with the number of entries modified + """ try: - _filter = {"_id": id} - collection = self.db[table] - rows = collection.replace_one(_filter, indata) + with self.lock: + collection = self.db[table] + rows = collection.update_many(self._format_filter(q_filter), {"$set": update_dict}) + return {"modified": rows.modified_count} + except Exception as e: # TODO refine + raise DbException(e) + + def replace(self, table, _id, indata, fail_on_empty=True): + """ + Replace the content of an entry + :param table: collection or table + :param _id: internal database id + :param indata: content to replace + :param fail_on_empty: If nothing matches filter it returns None unless this flag is set tu True, in which case + it raises a DbException + :return: Dict with the number of entries replaced + """ + try: + db_filter = {"_id": _id} + with self.lock: + collection = self.db[table] + rows = collection.replace_one(db_filter, indata) if rows.matched_count == 0: if fail_on_empty: - raise DbException("Not found any {} with filter='{}'".format(table[:-1], _filter), - HTTPStatus.NOT_FOUND) + raise DbException("Not found any {} with _id='{}'".format(table[:-1], _id), HTTPStatus.NOT_FOUND) return None return {"replaced": rows.modified_count} except Exception as e: # TODO refine - raise DbException(str(e)) + raise DbException(e)