BaseTools: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / BaseTools / Source / Python / Table / TableDec.py

## @file\r
# This file is used to create/update/query/erase table for dec datas\r
#\r
# Copyright (c) 2008 - 2018, Intel Corporation. All rights reserved.<BR>\r
# SPDX-License-Identifier: BSD-2-Clause-Patent\r
#\r
\r
##\r
# Import Modules\r
#\r
from __future__ import absolute_import\r
import Common.EdkLogger as EdkLogger\r
import CommonDataClass.DataClass as DataClass\r
from Table.Table import Table\r
from Common.StringUtils import ConvertToSqlString\r
\r
## TableDec\r
#\r
# This class defined a table used for data model\r
#\r
# @param object:       Inherited from object class\r
#\r
#\r
class TableDec(Table):\r
    def __init__(self, Cursor):\r
        Table.__init__(self, Cursor)\r
        self.Table = 'Dec'\r
\r
    ## Create table\r
    #\r
    # Create table Dec\r
    #\r
    # @param ID:             ID of a Dec item\r
    # @param Model:          Model of a Dec item\r
    # @param Value1:         Value1 of a Dec item\r
    # @param Value2:         Value2 of a Dec item\r
    # @param Value3:         Value3 of a Dec item\r
    # @param Arch:           Arch of a Dec item\r
    # @param BelongsToItem:  The item belongs to which another item\r
    # @param BelongsToFile:  The item belongs to which dsc file\r
    # @param StartLine:      StartLine of a Dec item\r
    # @param StartColumn:    StartColumn of a Dec item\r
    # @param EndLine:        EndLine of a Dec item\r
    # @param EndColumn:      EndColumn of a Dec item\r
    # @param Enabled:        If this item enabled\r
    #\r
    def Create(self):\r
        SqlCommand = """create table IF NOT EXISTS %s (ID INTEGER PRIMARY KEY,\r
                                                       Model INTEGER NOT NULL,\r
                                                       Value1 VARCHAR NOT NULL,\r
                                                       Value2 VARCHAR,\r
                                                       Value3 VARCHAR,\r
                                                       Arch VarCHAR,\r
                                                       BelongsToItem SINGLE NOT NULL,\r
                                                       BelongsToFile SINGLE NOT NULL,\r
                                                       StartLine INTEGER NOT NULL,\r
                                                       StartColumn INTEGER NOT NULL,\r
                                                       EndLine INTEGER NOT NULL,\r
                                                       EndColumn INTEGER NOT NULL,\r
                                                       Enabled INTEGER DEFAULT 0\r
                                                      )""" % self.Table\r
        Table.Create(self, SqlCommand)\r
\r
    ## Insert table\r
    #\r
    # Insert a record into table Dec\r
    #\r
    # @param ID:             ID of a Dec item\r
    # @param Model:          Model of a Dec item\r
    # @param Value1:         Value1 of a Dec item\r
    # @param Value2:         Value2 of a Dec item\r
    # @param Value3:         Value3 of a Dec item\r
    # @param Arch:           Arch of a Dec item\r
    # @param BelongsToItem:  The item belongs to which another item\r
    # @param BelongsToFile:  The item belongs to which dsc file\r
    # @param StartLine:      StartLine of a Dec item\r
    # @param StartColumn:    StartColumn of a Dec item\r
    # @param EndLine:        EndLine of a Dec item\r
    # @param EndColumn:      EndColumn of a Dec item\r
    # @param Enabled:        If this item enabled\r
    #\r
    def Insert(self, Model, Value1, Value2, Value3, Value4, Value5, Arch, BelongsToItem, BelongsToFile, StartLine, StartColumn, EndLine, EndColumn, Enabled):\r
        self.ID = self.ID + 1\r
        (Value1, Value2, Value3, Arch) = ConvertToSqlString((Value1, Value2, Value3, Arch))\r
        SqlCommand = """insert into %s values(%s, %s, '%s', '%s', '%s', '%s', %s, %s, %s, %s, %s, %s, %s)""" \\r
                     % (self.Table, self.ID, Model, Value1, Value2, Value3, Arch, BelongsToItem, BelongsToFile, StartLine, StartColumn, EndLine, EndColumn, Enabled)\r
        Table.Insert(self, SqlCommand)\r
\r
        return self.ID\r
\r
    ## Query table\r
    #\r
    # @param Model:  The Model of Record\r
    #\r
    # @retval:       A recordSet of all found records\r
    #\r
    def Query(self, Model):\r
        SqlCommand = """select ID, Value1, Value2, Value3, Arch, BelongsToItem, BelongsToFile, StartLine from %s\r
                        where Model = %s\r
                        and Enabled > -1""" % (self.Table, Model)\r
        EdkLogger.debug(4, "SqlCommand: %s" % SqlCommand)\r
        self.Cur.execute(SqlCommand)\r
        return self.Cur.fetchall()\r