c-core/04_core/core04Example_main.c

/* ----------------------------------------------------------------------------
 *
 * Raima Database Manager
 *
 * Copyright (c) 2019 Raima Inc.,  All rights reserved.
 *
 * Use of this software, whether in source code format, or in executable,
 * binary object code form, is governed by the Raima LICENSE which
 * is fully described in the LICENSE.TXT file, included within this
 * distribution of files.
 *
 * ----------------------------------------------------------------------------
 */

#include <stdio.h>
#include <string.h>
#include "example_fcns.h"
#include "rdm.h"
#include "rdmstartupapi.h"

/* Generated \c struct and \c typedef definitions to be used with the RDM APIs
 */
#include "core04_structs.h"

/* Generated catalog definition to be used with the RDM rdm_dbSetCatalog() API
 */
#include "core04_cat.h"

RDM_CMDLINE cmd;
const char *const description =
    "Demonstrates associating rows in one table with a row in another table";
const RDM_CMDLINE_OPT opts[] = {{NULL, NULL, NULL, NULL}};

RDM_RETCODE insertArtist (
    RDM_DB hDB,             
    const char *artistName, 
    RDM_CURSOR
        *artistCursor) 
{
    RDM_RETCODE rc;
    ARTIST artist_rec;

    artist_rec.artistid = 0;
    strncpy (artist_rec.name, artistName, sizeof (artist_rec.name));
    rc = rdm_dbInsertRow (
        hDB, TABLE_ARTIST, &artist_rec, sizeof (artist_rec), artistCursor);
    print_error (rc);

    return rc;
}

RDM_RETCODE insertAlbum (
    RDM_DB hDB,              
    RDM_CURSOR artistCursor, 
    const char *albumTitle,  
    const char **trackList,  
    size_t listSize)         
{
    RDM_RETCODE rc;
    ALBUM album_rec;
    RDM_CURSOR cursor = NULL;

    /* read the artistID from the artistCursor row */
    rc = rdm_cursorReadColumn (
        artistCursor, COL_ARTIST_ARTISTID, &album_rec.artistid,
        sizeof (album_rec.artistid), NULL);
    print_error (rc);
    strncpy (album_rec.title, albumTitle, sizeof (album_rec.title));
    album_rec.albumid = 0;

    rc = rdm_dbInsertRow (
        hDB, TABLE_ALBUM, &album_rec, sizeof (album_rec), &cursor);
    print_error (rc);

    if (rc == sOKAY)
    {
        int ii;
        TRACK track_rec;

        /* read the albumID from the album cursor row we just inserted */
        rc = rdm_cursorReadColumn (
            cursor, COL_ALBUM_ALBUMID, &track_rec.albumid,
            sizeof (track_rec.albumid), NULL);
        print_error (rc);

        for (ii = 0; ii < (int) listSize; ii++)
        {
            strncpy (track_rec.title, trackList[ii], sizeof (track_rec.title));
            rc = rdm_dbInsertRow (
                hDB, TABLE_TRACK, &track_rec, sizeof (track_rec), NULL);
            print_error (rc);
        }
    }

    if (cursor)
        rdm_cursorFree (cursor);
    return rc;
}

RDM_RETCODE readAllAlbums (
    RDM_DB hDB) 
{
    RDM_RETCODE rc;
    RDM_CURSOR artistCursor = NULL;

    /* Loop through each artist record and diplay the albums/tracks it
       is associated with
     */
    printf ("\nList all artists and their albums/tracks\n");

    rc = rdm_dbStartRead (hDB, RDM_LOCK_ALL, 0, NULL);
    print_error (rc);

    if (rc == sOKAY)
    {
        /* read the ARTIST table in table order */
        rc = rdm_dbGetRows (hDB, TABLE_ARTIST, &artistCursor);
        print_error (rc);

        if (rc == sOKAY)
        {
            for (rc = rdm_cursorMoveToFirst (artistCursor); rc == sOKAY;
                 rc = rdm_cursorMoveToNext (artistCursor))
            {
                RDM_CURSOR albumCursor = NULL;
                char Artist[RDM_COLUMN_SIZE (ARTIST, name)];

                /* We found an artist row, read the contents */
                rc = rdm_cursorReadColumn (
                    artistCursor, COL_ARTIST_NAME, Artist, sizeof (Artist),
                    NULL);
                print_error (rc);

                if (rc == sOKAY)
                {
                    printf ("\nArtist: %s\n", Artist);
                    /* read the album rows associated with the artist*/
                    rc = rdm_cursorGetMemberRows (
                        artistCursor, REF_ALBUM_ARTISTID, &albumCursor);
                    print_error (rc);

                    if (rc == sOKAY)
                    {
                        for (rc = rdm_cursorMoveToFirst (albumCursor);
                             rc == sOKAY;
                             rc = rdm_cursorMoveToNext (albumCursor))
                        {
                            RDM_CURSOR trackCursor = NULL;
                            char Title[RDM_COLUMN_SIZE (ALBUM, title)];

                            /* We found an album row, read the contents*/
                            rc = rdm_cursorReadColumn (
                                albumCursor, COL_ALBUM_TITLE, Title,
                                sizeof (Title), NULL);
                            print_error (rc);

                            if (rc == sOKAY)
                            {
                                printf ("\n\tAlbum: %s\n", Title);
                                rc = rdm_cursorGetMemberRows (
                                    albumCursor, REF_TRACK_ALBUMID,
                                    &trackCursor);
                                print_error (rc);

                                if (rc == sOKAY)
                                {
                                    for (rc = rdm_cursorMoveToFirst (
                                             trackCursor);
                                         rc == sOKAY;
                                         rc =
                                             rdm_cursorMoveToNext (trackCursor))
                                    {
                                        char Track[RDM_COLUMN_SIZE (
                                            TRACK, title)];

                                        /* We found an album row, read the
                                         * contents*/
                                        rc = rdm_cursorReadColumn (
                                            trackCursor, COL_TRACK_TITLE, Track,
                                            sizeof (Track), NULL);
                                        print_error (rc);

                                        if (rc == sOKAY)
                                        {
                                            printf ("\t\t%s\n", Track);
                                        }
                                    }
                                    rdm_cursorFree (trackCursor);
                                }
                            }
                        }
                        rdm_cursorFree (albumCursor);
                    }
                }
            }
            rdm_cursorFree (artistCursor);
            /* We expect rc to be sENDOFCURSOR when we break out of the loop */
            if (rc == sENDOFCURSOR)
            {
                rc = sOKAY; /* change status to sOKAY because sENDOFCURSOR was
                               expected. */
            }
            else
            {
                print_error (rc);
            }
        }
        rdm_dbEnd (hDB);
    }
    return rc;
}

/* Track data to insert */
static const char *the_doors_tracks[] = {"Break on Through (To the Other Side)",
                                         "Soul Kitchen",
                                         "The Crystal Ship",
                                         "Twentieth Century Fox",
                                         "Alabama Song (Whisky Bar)",
                                         "Light My Fire",
                                         "Back Door Man",
                                         "I Looked at You",
                                         "End of the Night",
                                         "Take It as It Comes",
                                         "The End"};

static const char *strange_days_tracks[] = {"Strange Days",
                                            "You're Lost Little Girl",
                                            "Love Me Two Times",
                                            "Unhappy Girl",
                                            "Horse Latitudes",
                                            "Moonlight Drive",
                                            "People Are Strange",
                                            "My Eyes Have Seen You",
                                            "I Can't See Your Face in My Mind",
                                            "When the Music's Over"};

static const char *waiting_tracks[] = {
    "Hello, I Love You",    "Love Street",     "Not to Touch the Earth",
    "Summer's Almost Gone", "Wintertime Love", "The Unknown Soldier",
    "Spanish Caravan",      "My Wild Love",    "We Could Be So Good Together",
    "Yes, the River Knows", "Five to One"};

static const char *the_rolling_stones_tracks[] = {
    "Not Fade Away",
    "Route 66",
    "I Just Want to Make Love to You",
    "Honest I Do",
    "Now I've Got a Witness",
    "Little by Little",
    "I'm a King Bee",
    "Carol",
    "Tell Me",
    "Can I Get a Witness",
    "You Can Make It If You Try",
    "Walking the Dog"};

static const char *out_of_our_heads_tracks[] = {
    "She Said Yeah",
    "Mercy, Mercy",
    "Hitch Hike",
    "That's How Strong My Love Is",
    "Good Times",
    "Gotta Get Away",
    "Talkin' Bout You",
    "Cry to Me",
    "Oh, Baby (We Got a Good Thing Going)",
    "Heart of Stone",
    "The Under Assistant West Coast Promotion Man",
    "I'm Free"};

static const char *beggars_banquet_tracks[] = {
    "Sympathy for the Devil", "No Expectations", "Dear Doctor",
    "Parachute Woman",        "Jig-Saw Puzzle",  "Street Fighting Man",
    "Prodigal Son",           "Stray Cat Blues", "Factory Girl",
    "Salt of the Earth"};

static const char *tattoo_you_tracks[] = {"Start Me Up",
                                          "Hang Fire",
                                          "Slave",
                                          "Little T&A",
                                          "Black Limousine",
                                          "Neighbours",
                                          "Worried About You",
                                          "Tops",
                                          "Heaven"};

static const char *bleach_tracks[] = {
    "Blew",      "Floyd The Barber", "About a Girl",   "School",
    "Love Buzz", "Paper Cuts",       "Negative Creep", "Scoff",
    "Swap Meet", "Mr. Moustache",    "Sifting"};

static const char *nevermind_tracks[] = {"Smells Like Teen Spirit",
                                         "In Bloom",
                                         "Come as You Are",
                                         "Breed",
                                         "Lithium",
                                         "Polly",
                                         "Territorial Pissings",
                                         "Drain You",
                                         "Lounge Act",
                                         "Stay Away",
                                         "On a Plain",
                                         "Something in the Way",
                                         "Endless, Nameless"};

static const char *in_utero_tracks[] = {
    "Serve the Servants",
    "Scentless Apprentice",
    "Heart-Shaped Box",
    "Rape Me",
    "Frances Farmer Will Have Her Revenge on Seattle",
    "Dumb",
    "Very Ape",
    "Milk It",
    "Pennyroyal Tea",
    "Radio Friendly Unit Shifter",
    "tourette's",
    "All Apologies"};

#define RLEN(x) (sizeof (x) / sizeof (x[0]))

RDM_RETCODE insertAllArtists (RDM_DB hDB)
{
    RDM_RETCODE rc;
    RDM_CURSOR artistCursor = NULL;

    rc = rdm_dbStartUpdate (hDB, RDM_LOCK_ALL, 0, NULL, 0, NULL);
    print_error (rc);
    if (rc == sOKAY)
    {
        insertArtist (hDB, "The Doors", &artistCursor);
        insertAlbum (
            hDB, artistCursor, "The Doors", the_doors_tracks,
            RLEN (the_doors_tracks));
        insertAlbum (
            hDB, artistCursor, "Strange Days", strange_days_tracks,
            RLEN (strange_days_tracks));
        insertAlbum (
            hDB, artistCursor, "Waiting for the Sun", waiting_tracks,
            RLEN (waiting_tracks));

        /* if insert of both Artist and Album are ok,
         * commit the transaction, otherwise roll it back */
        if (rc == sOKAY)
            rc = rdm_dbEnd (hDB);
        else
            rc = rdm_dbEndRollback (hDB);
    }

    rc = rdm_dbStartUpdate (hDB, RDM_LOCK_ALL, 0, NULL, 0, NULL);
    print_error (rc);
    if (rc == sOKAY)
    {
        insertArtist (hDB, "The Rolling Stones", &artistCursor);
        insertAlbum (
            hDB, artistCursor, "The Rolling Stones", the_rolling_stones_tracks,
            RLEN (the_rolling_stones_tracks));
        insertAlbum (
            hDB, artistCursor, "Out of our Heads", out_of_our_heads_tracks,
            RLEN (out_of_our_heads_tracks));
        insertAlbum (
            hDB, artistCursor, "Beggars Banquest", beggars_banquet_tracks,
            RLEN (beggars_banquet_tracks));
        insertAlbum (
            hDB, artistCursor, "Tattoo You", tattoo_you_tracks,
            RLEN (tattoo_you_tracks));

        /* if insert of both Artist and Album are ok,
         * commit the transaction, otherwise roll it back */
        if (rc == sOKAY)
            rc = rdm_dbEnd (hDB);
        else
            rc = rdm_dbEndRollback (hDB);
    }

    rc = rdm_dbStartUpdate (hDB, RDM_LOCK_ALL, 0, NULL, 0, NULL);
    print_error (rc);
    if (rc == sOKAY)
    {
        insertArtist (hDB, "Nirvana", &artistCursor);
        insertAlbum (
            hDB, artistCursor, "Bleach", bleach_tracks, RLEN (bleach_tracks));
        insertAlbum (
            hDB, artistCursor, "Nevermind", nevermind_tracks,
            RLEN (nevermind_tracks));
        insertAlbum (
            hDB, artistCursor, "In Utero", in_utero_tracks,
            RLEN (in_utero_tracks));

        /* if insert of both Artist and Album are ok,
         * commit the transaction, otherwise roll it back */
        if (rc == sOKAY)
            rc = rdm_dbEnd (hDB);
        else
            rc = rdm_dbEndRollback (hDB);
    }
    return rc;
}

int main_core04 (int argc, const char *const *argv)
{
    RDM_TFS hTFS;
    RDM_DB hDB;
    RDM_RETCODE rc;

    rc = rdm_cmdlineInit (&cmd, argc, argv, description, opts);
    if (rc != sCMD_USAGE)
        print_error (rc);
    if (rc == sOKAY)
    {
        rc = exampleOpenEmptyDatabase (&hTFS, &hDB, "core04", core04_cat);
        if (rc == sOKAY)
        {
            rc = insertAllArtists (hDB);
            if (rc == sOKAY)
            {
                rc = readAllAlbums (hDB);
            }
            exampleCleanup (hTFS, hDB);
        }
    }

    return (int) rc;
}

RDM_STARTUP_EXAMPLE (core04)