Apex中文手册

数据库类方法是使用DML语句的另一种方法，它比DML语句更灵活，如插入，更新等。

数据库方法和DML语句之间的差异

DML语句	数据库方法
不允许部分更新。 例如，如果列表中有20条记录，则所有记录都将更新或不更新。	允许部分更新。 您可以在Database方法中指定参数为true或false，true表示允许部分更新，false表示不允许相同。
您无法获取成功和失败记录的列表。	您可以获取成功和失败记录的列表，如我们在示例中看到的。
示例：insert listName;	示例：Database.insert（listName，False），其中false表示不允许部分更新。

INSERT插入操作

通过数据库方法插入新记录也非常简单和灵活。 让我们采用前面的场景，其中我们使用DML语句插入了新的记录。 我们将插入相同的使用数据库方法。

例如：

//Insert Operation Using Database methods
//Insert Customer Records First using simple DML Statement. This Customer Record will be used when we will create Invoice Records
APEX_Customer__c objCust = new APEX_Customer__C();
objCust.Name = 'Test';
insert objCust;//Inserting the Customer Records
	
//Insert Operation Using Database methods
APEX_Invoice__c objNewInvoice = new APEX_Invoice__c();
List<apex_invoice__c> InvoiceListToInsert = new List<apex_invoice__c>();
objNewInvoice.APEX_Status__c = 'Pending';
objNewInvoice.APEX_Customer__c = objCust.id;
objNewInvoice.APEX_Amount_Paid__c = 1000;
InvoiceListToInsert.add(objNewInvoice);
Database.SaveResult[] srList = Database.insert(InvoiceListToInsert, false);//Database method to insert the records in List
	
// Iterate through each returned result by the method
for (Database.SaveResult sr : srList) {
	if (sr.isSuccess()) {
    // This condition will be executed for successful records and will fetch the ids of successful records
	System.debug('Successfully inserted Invoice. Invoice ID: ' + sr.getId());//Get the invoice id of inserted Account
	}
else {
    // This condition will be executed for failed records
	for(Database.Error objErr : sr.getErrors()) {
		System.debug('The following error has occurred.');  //Printing error message in Debug log
		System.debug(objErr.getStatusCode() + ': ' + objErr.getMessage());
		System.debug('Invoice oject field which are affected by the error: ' + objErr.getFields());
	}
}
}

UPDATE更新操作

让我们来看看使用数据库方法的业务案例示例。 假设我们想更新Invoice对象的状态字段，但是同时，我们希望有诸如记录状态，失败的记录ID，成功计数等信息。这是不可能通过使用DML语句完成的，因此我们必须使用数据库方法来获取我们操作的状态。

例如：

如果发票的状态为“待处理”，且创建日期为今天，我们将更新发票的“状态”字段。

下面的代码是使用Database.update方法更新发票记录。 此外，在执行此代码之前创建发票记录。

//Code to update the records using the Database methods
List<apex_invoice__c> invoiceList = [SELECT id, Name, APEX_Status__c, createdDate FROM APEX_Invoice__c WHERE createdDate = today];//fetch the invoice created today
List<apex_invoice__c> updatedInvoiceList = new List<apex_invoice__c>();
for (APEX_Invoice__c objInvoice: invoiceList) {
	if (objInvoice.APEX_Status__c == 'Pending') {
		objInvoice.APEX_Status__c = 'Paid';
		updatedInvoiceList.add(objInvoice);//Adding records to the list
	}
	
}
Database.SaveResult[] srList = Database.update(updatedInvoiceList, false);//Database method to update the records in List


// Iterate through each returned result by the method
for (Database.SaveResult sr : srList) {
if (sr.isSuccess()) {
    // This condition will be executed for successful records and will fetch the ids of successful records
    System.debug('Successfully updated Invoice. Invoice ID is : ' + sr.getId());
}
else {
    // This condition will be executed for failed records
	for(Database.Error objErr : sr.getErrors()) {
		System.debug('The following error has occurred.');//Printing error message in Debug log
		System.debug(objErr.getStatusCode() + ': ' + objErr.getMessage());
		System.debug('Invoice oject field which are affected by the error: ' + objErr.getFields());
	}
}
}

我们将只看本教程中的插入和更新操作.。 其他操作与这些操作非常相似，我们在上一章中做过了。

---