Issue 100 capture database entries

[rahlk]

Motivation and Context

We now support the following frameworks

• Jakarta and JavaEE JPA CRUD operations.
• Springboot
• JDBC

How Has This Been Tested?

We have added a new test case to our integration testing suite and we have verified that it runs on plantsbywebsphere

package com.ibm.cldk;

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.Assertions;
import org.testcontainers.containers.BindMode;
import org.testcontainers.containers.GenericContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;
import org.testcontainers.utility.MountableFile;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Properties;

@Testcontainers
@SuppressWarnings("resource")
public class CodeAnalyzerIntegrationTest {
    // ...
    @Test
    void shouldBeAbleToDetectCRUDOperationsAndQueriesForPlantByWebsphere() throws Exception {
        var runCodeAnalyzerOnPlantsByWebsphere = container.execInContainer(
                "java",
                "-jar",
                String.format("/opt/jars/codeanalyzer-%s.jar", codeanalyzerVersion),
                "--input=/test-applications/plantsbywebsphere",
                "--analysis-level=1", "--verbose"
        );
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"query_type\": \"NAMED\""), "No entry point classes found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"READ\""), "No entry point methods found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"UPDATE\""), "No entry point methods found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"CREATE\""), "No entry point methods found");
    }
}

Breaking Changes

Yes. analysis.json has new fields, so cldk's python-sdk will break if this new version of codeanalyzer-2.2.0-dev is used.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the Codellm-Devkit Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional context

A number of new interfaces and enums were added, some of them will be backported to refactor the entrypoint detection offered in v2.1.0 of codeanalyzer.

[rahlk]

I have also made it so that we can get the crud operations easily directly form Callable entity. Added a couple of additional assertions to evaluate that we are indeed capturing the crud operations in the Callable object as expected.

package com.ibm.cldk;

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.Assertions;
import org.testcontainers.containers.BindMode;
import org.testcontainers.containers.GenericContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;
import org.testcontainers.utility.MountableFile;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Properties;

@Testcontainers
@SuppressWarnings("resource")
public class CodeAnalyzerIntegrationTest {
    // ...
    @Test
    void shouldBeAbleToDetectCRUDOperationsAndQueriesForPlantByWebsphere() throws Exception {
        var runCodeAnalyzerOnPlantsByWebsphere = container.execInContainer(
                "java",
                "-jar",
                String.format("/opt/jars/codeanalyzer-%s.jar", codeanalyzerVersion),
                "--input=/test-applications/plantsbywebsphere",
                "--analysis-level=1", "--verbose"
        );
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"query_type\": \"NAMED\""), "No entry point classes found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"READ\""), "No entry point methods found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"UPDATE\""), "No entry point methods found");
        Assertions.assertTrue(runCodeAnalyzerOnPlantsByWebsphere.getStdout().contains("\"operation_type\": \"CREATE\""), "No entry point methods found");
        // Convert the expected JSON structure into a string
        String expectedCrudOperation =
                "\"crud_operations\": [" +
                        "{" +
                        "\"line_number\": 115," +
                        "\"operation_type\": \"READ\"," +
                        "\"target_table\": null," +
                        "\"involved_fields\": null," +
                        "\"condition\": null," +
                        "\"joined_tables\": null," +
                        "\"technology\": null," +
                        "\"is_batch_operation\": false" +
                        "}]";

        // Expected JSON for CRUD Queries
        String expectedCrudQuery =
                "\"crud_queries\": [" +
                        "{" +
                        "\"line_number\": 141,";

        // Normalize the output and expected strings to ignore formatting differences
        String normalizedOutput = output.replaceAll("\\s+", "");
        String normalizedExpectedCrudOperation = expectedCrudOperation.replaceAll("\\s+", "");
        String normalizedExpectedCrudQuery = expectedCrudQuery.replaceAll("\\s+", "");

        // Assertions for both CRUD operations and queries
        Assertions.assertTrue(normalizedOutput.contains(normalizedExpectedCrudOperation), "Expected CRUD operation JSON structure not found");
        Assertions.assertTrue(normalizedOutput.contains(normalizedExpectedCrudQuery), "Expected CRUD query JSON structure not found");
    }
}