Business objects (BOs) implement the software's business logic. They Basically they are entity managers responsible for handling data objects (constructing, loading, saving, deleting) and any other business logic related to the business modulespecific entity. For every data object, there is a business object that handles it. Business objects offer services to the Controller layer (UI, API, Process) but they do not implement any process flows.

In CRM.COM Software, business object classes are implemented using EJBs (Enterprise Java Beans) J2EE server-side components, and more specifically, Stateless Session Beans. More information about EJBs can be found here.

What does this section cover?

    /**
     * Deletes a bank branch.
     * 
     * @param dto - the bank branch to delete
     * @return the deleted bank branch
     * @throws Exception
     */
	@Override
	protected CRMDO deleteDO(CRMDO dto) throws Exception {
		return dto;
	}

     /**
     * Validates a bank branch on save.
     * 
     * @param dto - the bank branch to validate
     * @throws Exception
     */
	@Override
	protected void validateDOonSave(CRMDO dto) throws Exception {
		CRMDOBankBranch bankBranch = (CRMDOBankBranch)dto;
		validateUniqueness(bankBranch);
	}

     /**
     * Validates the uniqueness of a bank branch.
     * 
     * @param bankBranch - the bank branch to validate
     * @throws Exception
     */
	protected void validateUniqueness(CRMDOBankBranch bankBranch) throws Exception {
		//Validate that there is no other bank branch with the same name
		validatorBean.validateUniqueRecordAgainstDb(
				bankBranch, 
				new String[]{"name"}, 
				new String[]{"Name"}, 
				"Branch", 
				true, 
				null);
		
		//Validate that there is no other bank branch with the same alternative code
		validatorBean.validateUniqueRecordAgainstDb(
				bankBranch, 
				new String[]{"altCode"}, 
				new String[]{"Alternative Code"}, 
				"Branch", 
				true, 
				null);

    /**
     * Validates a bank branch on delete.
     * 
     * @param dto - the bank branch to validate
     * @throws Exception
     */
	@Override
	protected void validateDOonDelete(CRMDO dto) throws Exception {
		CRMDOBankBranch bankBranch = (CRMDOBankBranch)dto;
    	
		//Validate that the bank branch is not defined in any non-terminated accounts receivable payment preference
		validateIfUsedByAccountsOnDelete(bankBranch);
	}

    /**
     * Returns the data object class of a bank branch.
     * 
     * @return the data object class of the bank branch
     */
	@Override
	protected Class<CRMDOBankBranch> getDataObjectClass() {
		return CRMDOBankBranch.class;
	}

     /**
     * Returns the default associated data objects of a bank branch.
     * 
     * @return the default associated data objects of the bank branch
     */
	@Override
	public ArrayList<String> getDefaultAssociations() {
		
		ArrayList<String> defaultAssociations = new ArrayList<String>();
		
		defaultAssociations.add("createdByUser");
		defaultAssociations.add("updatedByUser");
		defaultAssociations.add("createdByUnit");
		defaultAssociations.add("updatedByUnit");
		defaultAssociations.add("bank");
		
		return defaultAssociations;
	}

    /**
     * Returns the next sequence number of a bank branch.
     * 
     * @param dto - the bank branch to return the next sequence number for
     * @return the next sequence number of the bank branch
     * @throws Exception
     */
	@Override
	protected String getSequenceNumber(CRMDO dto) throws Exception {
		//No sequence number must be returned
		return null;
	}

    /**
     * Returns the next sequence number of an account definition.
     * 
     * @param dto - the account definition to return the next sequence number for
     * @return the next sequence number of the account definition
     * @throws Exception
     */
	@Override
	protected String getSequenceNumber(CRMDO dto) throws Exception {
		return getNextSequenceNumber(SequenceNumber.ACCDEFINITIONSnumberSchemeBean.getNextNumber("JOBS");
	}

    /**
     * Returns the mandatory fields of a bank branch.
     * 
     * @param dto - the bank branch to return the mandatory fields for
     * @return the mandatory fields of the bank branch
     * @throws Exception
     */
	@Override
	protected LinkedHashMap<String, String> getMandatoryFields(CRMDO dto) throws Exception {
		
		LinkedHashMap<String, String> mandatoryFields = new LinkedHashMap<String, String>();
		
		mandatoryFields.put("key_name", "name");
		mandatoryFields.put("key_alternative_code", "altCode");
		
		return mandatoryFields;
	}

+
					"   left join accountpaymentpreference.account " +
					"   left join accountpaymentpreference.bankBranch " +
					"   where accountpaymentpreference.bankBranch.id=:p" + values.size() + " and " +
					"   accountpaymentpreference.account.id=" + getDOName().toLowerCase() + ".id and " +
					"   accountpaymentpreference.isDeleted=0 " + 
					" )";
		}
				
		return load(
				getDOName().toLowerCase() + ".lifeCycleState!='" + AccountReceivableLifeCycleState.TERMINATED + "' and " + 
				getDOName().toLowerCase() + ".isDeleted=0" + criteria, 
				values, 
				associations, 
				null, 
				null);
	}