blob: d7c5be2286740263e82f1d953d06002d45b79291 [file] [log] [blame]
-- C392003.A
--
-- Grant of Unlimited Rights
--
-- Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687,
-- F08630-91-C-0015, and DCA100-97-D-0025, the U.S. Government obtained
-- unlimited rights in the software and documentation contained herein.
-- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making
-- this public release, the Government intends to confer upon all
-- recipients unlimited rights equal to those held by the Government.
-- These rights include rights to use, duplicate, release or disclose the
-- released technical data and computer software in whole or in part, in
-- any manner and for any purpose whatsoever, and to have or permit others
-- to do so.
--
-- DISCLAIMER
--
-- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR
-- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED
-- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE
-- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE
-- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A
-- PARTICULAR PURPOSE OF SAID MATERIAL.
--*
--
-- OBJECTIVE:
-- Check that the use of a class-wide formal parameter allows for the
-- proper dispatching of objects to the appropriate implementation of
-- a primitive operation. Check this where the root tagged type is
-- defined in a package, and the extended type is defined in a nested
-- package.
--
-- TEST DESCRIPTION:
-- Declare a root tagged type, and some associated primitive operations.
-- Extend the root type, and override one or more primitive operations,
-- inheriting the other primitive operations from the root type.
-- Derive from the extended type, again overriding some primitive
-- operations and inheriting others (including some that the parent
-- inherited).
-- Define a subprogram with a class-wide parameter, inside of which is a
-- call on a dispatching primitive operation. These primitive operations
-- modify global variables (the class-wide parameter has mode IN).
--
--
--
-- The following hierarchy of tagged types and primitive operations is
-- utilized in this test:
--
-- type Bank_Account (root)
-- |
-- | Operations
-- | Increment_Bank_Reserve
-- | Assign_Representative
-- | Increment_Counters
-- | Open
-- |
-- type Savings_Account (extended from Bank_Account)
-- |
-- | Operations
-- | (Increment_Bank_Reserve) (inherited)
-- | Assign_Representative (overridden)
-- | Increment_Counters (overridden)
-- | Open (overridden)
-- |
-- type Preferred_Account (extended from Savings_Account)
-- |
-- | Operations
-- | (Increment_Bank_Reserve) (inherited twice - Bank_Acct.)
-- | (Assign_Representative) (inherited - Savings_Acct.)
-- | Increment_Counters (overridden)
-- | Open (overridden)
--
--
-- In this test, we are concerned with the following selection of dispatching
-- calls, accomplished with the use of a Bank_Account'Class IN procedure
-- parameter :
--
-- \ Type
-- Prim. Op \ Bank_Account Savings_Account Preferred_Account
-- \------------------------------------------------
-- Increment_Bank_Reserve| X X
-- Assign_Representative | X
-- Increment_Counters | X X X
--
--
--
-- The location of the declaration and derivation of the root and extended
-- types will be varied over a series of tests. Locations of declaration
-- and derivation for a particular test are marked with an asterisk (*).
--
-- Root type:
--
-- * Declared in package.
-- Declared in generic package.
--
-- Extended types:
--
-- Derived in parent location.
-- * Derived in a nested package.
-- Derived in a nested subprogram.
-- Derived in a nested generic package.
-- Derived in a separate package.
-- Derived in a separate visible child package.
-- Derived in a separate private child package.
--
-- Primitive Operations:
--
-- * Procedures with same parameter profile.
-- Procedures with different parameter profile.
-- * Functions with same parameter profile.
-- Functions with different parameter profile.
-- * Mixture of Procedures and Functions.
--
--
-- CHANGE HISTORY:
-- 06 Dec 94 SAIC ACVC 2.0
--
--!
with Report;
procedure C392003 is
--
-- Types and subtypes.
--
type Dollar_Amount is new float;
type Interest_Rate is delta 0.001 range 0.000 .. 1.000;
type Account_Types is (Bank, Savings, Preferred, Total);
type Account_Counter is array (Account_Types) of integer;
type Account_Rep is (President, Manager, New_Account_Manager, Teller);
--
-- Constants.
--
Opening_Balance : constant Dollar_Amount := 100.00;
Current_Rate : constant Interest_Rate := 0.030;
Preferred_Minimum_Balance : constant Dollar_Amount := 1000.00;
--
-- Global Variables
--
Bank_Reserve : Dollar_Amount := 0.00;
Daily_Representative : Account_Rep := New_Account_Manager;
Number_Of_Accounts : Account_Counter := (Bank => 0,
Savings => 0,
Preferred => 0,
Total => 0);
-- Root tagged type and primitive operations declared in internal
-- package (Accounts).
-- Extended types (and primitive operations) derived in nested packages.
--=================================================================--
package Accounts is
--
-- Root account type and primitive operations.
--
-- Root type.
type Bank_Account is tagged
record
Balance : Dollar_Amount;
end record;
-- Primitive operations of Bank_Account.
function Increment_Bank_Reserve (Acct : in Bank_Account)
return Dollar_Amount;
function Assign_Representative (Acct : in Bank_Account)
return Account_Rep;
procedure Increment_Counters (Acct : in Bank_Account);
procedure Open (Acct : in out Bank_Account);
--=================================================================--
package S_And_L is
-- Declare extended type in a nested package.
type Savings_Account is new Bank_Account with
record
Rate : Interest_Rate;
end record;
-- Function Increment_Bank_Reserve inherited from
-- parent (Bank_Account).
-- Primitive operations (Overridden).
function Assign_Representative (Acct : in Savings_Account)
return Account_Rep;
procedure Increment_Counters (Acct : in Savings_Account);
procedure Open (Acct : in out Savings_Account);
--=================================================================--
package Premium is
-- Declare further extended type in a nested package.
type Preferred_Account is new Savings_Account with
record
Minimum_Balance : Dollar_Amount;
end record;
-- Function Increment_Bank_Reserve inherited twice.
-- Function Assign_Representative inherited from parent
-- (Savings_Account).
-- Primitive operation (Overridden).
procedure Increment_Counters (Acct : in Preferred_Account);
procedure Open (Acct : in out Preferred_Account);
-- Function used to verify Open operation for Preferred_Account
-- objects.
function Verify_Open (Acct : in Preferred_Account) return Boolean;
end Premium;
end S_And_L;
end Accounts;
--=================================================================--
package body Accounts is
--
-- Primitive operations for Bank_Account.
--
function Increment_Bank_Reserve (Acct : in Bank_Account)
return Dollar_Amount is
begin
return (Bank_Reserve + Acct.Balance);
end Increment_Bank_Reserve;
function Assign_Representative (Acct : in Bank_Account)
return Account_Rep is
begin
return Account_Rep'(Teller);
end Assign_Representative;
procedure Increment_Counters (Acct : in Bank_Account) is
begin
Number_Of_Accounts (Bank) := Number_Of_Accounts (Bank) + 1;
Number_Of_Accounts (Total) := Number_Of_Accounts (Total) + 1;
end Increment_Counters;
procedure Open (Acct : in out Bank_Account) is
begin
Acct.Balance := Opening_Balance;
end Open;
--=================================================================--
package body S_And_L is
--
-- Overridden operations for Savings_Account type.
--
function Assign_Representative (Acct : in Savings_Account)
return Account_Rep is
begin
return (Manager);
end Assign_Representative;
procedure Increment_Counters (Acct : in Savings_Account) is
begin
Number_Of_Accounts (Savings) := Number_Of_Accounts (Savings) + 1;
Number_Of_Accounts (Total) := Number_Of_Accounts (Total) + 1;
end Increment_Counters;
procedure Open (Acct : in out Savings_Account) is
begin
Open (Bank_Account(Acct));
Acct.Rate := Current_Rate;
Acct.Balance := 2.0 * Opening_Balance;
end Open;
--=================================================================--
package body Premium is
--
-- Overridden operations for Preferred_Account type.
--
procedure Increment_Counters (Acct : in Preferred_Account) is
begin
Number_Of_Accounts (Preferred) :=
Number_Of_Accounts (Preferred) + 1;
Number_Of_Accounts (Total) :=
Number_Of_Accounts (Total) + 1;
end Increment_Counters;
procedure Open (Acct : in out Preferred_Account) is
begin
Open (Savings_Account(Acct));
Acct.Minimum_Balance := Preferred_Minimum_Balance;
Acct.Balance := Acct.Minimum_Balance;
end Open;
--
-- Function used to verify Open operation for Preferred_Account
-- objects.
--
function Verify_Open (Acct : in Preferred_Account)
return Boolean is
begin
return (Acct.Balance = Preferred_Minimum_Balance and
Acct.Rate = Current_Rate and
Acct.Minimum_Balance = Preferred_Minimum_Balance);
end Verify_Open;
end Premium;
end S_And_L;
end Accounts;
--=================================================================--
-- Declare account objects.
B_Account : Accounts.Bank_Account;
S_Account : Accounts.S_And_L.Savings_Account;
P_Account : Accounts.S_And_L.Premium.Preferred_Account;
-- Procedures to operate on accounts.
-- Each uses a class-wide IN parameter, as well as a call to a
-- dispatching operation.
-- Function Tabulate_Account performs a dispatching call on a primitive
-- operation that has been overridden for each of the extended types.
procedure Tabulate_Account (Acct : in Accounts.Bank_Account'Class) is
begin
Accounts.Increment_Counters (Acct); -- Dispatch according to tag.
end Tabulate_Account;
-- Function Accumulate_Reserve performs a dispatching call on a
-- primitive operation that has been defined for the root type and
-- inherited by each derived type.
function Accumulate_Reserve (Acct : in Accounts.Bank_Account'Class)
return Dollar_Amount is
begin
-- Dispatch according to tag.
return (Accounts.Increment_Bank_Reserve (Acct));
end Accumulate_Reserve;
-- Procedure Resolve_Dispute performs a dispatching call on a primitive
-- operation that has been defined in the root type, overridden in the
-- first derived extended type, and inherited by the subsequent extended
-- type.
procedure Resolve_Dispute (Acct : in Accounts.Bank_Account'Class) is
begin
-- Dispatch according to tag.
Daily_Representative := Accounts.Assign_Representative (Acct);
end Resolve_Dispute;
--=================================================================--
begin -- Main test procedure.
Report.Test ("C392003", "Check that the use of a class-wide parameter " &
"allows for proper dispatching where root type " &
"is declared in a nested package, and " &
"subsequent extended types are derived in " &
"further nested packages" );
Bank_Account_Subtest:
begin
Accounts.Open (B_Account);
-- Demonstrate class-wide parameter allowing dispatch by a primitive
-- operation that has been defined for this specific type.
Bank_Reserve := Accumulate_Reserve (Acct => B_Account);
Tabulate_Account (B_Account);
if (Bank_Reserve /= Opening_Balance) or
(Number_Of_Accounts (Bank) /= 1) or
(Number_Of_Accounts (Total) /= 1)
then
Report.Failed ("Failed in Bank_Account_Subtest");
end if;
end Bank_Account_Subtest;
Savings_Account_Subtest:
begin
Accounts.S_And_L.Open (Acct => S_Account);
-- Demonstrate class-wide parameter allowing dispatch by a primitive
-- operation that has been overridden for this extended type.
Resolve_Dispute (Acct => S_Account);
Tabulate_Account (S_Account);
if (Daily_Representative /= Manager) or
(Number_Of_Accounts (Savings) /= 1) or
(Number_Of_Accounts (Total) /= 2)
then
Report.Failed ("Failed in Savings_Account_Subtest");
end if;
end Savings_Account_Subtest;
Preferred_Account_Subtest:
begin
Accounts.S_And_L.Premium.Open (P_Account);
-- Verify that the correct implementation of Open (overridden) was
-- used for the Preferred_Account object.
if not Accounts.S_And_L.Premium.Verify_Open (P_Account) then
Report.Failed ("Incorrect values for init. Preferred Acct object");
end if;
-- Demonstrate class-wide parameter allowing dispatch by a primitive
-- operation that has been twice inherited by this extended type.
Bank_Reserve := Accumulate_Reserve (Acct => P_Account);
-- Demonstrate class-wide parameter allowing dispatch by a primitive
-- operation that has been overridden for this extended type (the
-- operation was overridden by its parent type as well).
Tabulate_Account (P_Account);
if Bank_Reserve /= 1100.00 or
Number_Of_Accounts (Preferred) /= 1 or
Number_Of_Accounts (Total) /= 3
then
Report.Failed ("Failed in Preferred_Account_Subtest");
end if;
end Preferred_Account_Subtest;
Report.Result;
end C392003;