Java Function: SearchStudent

This document outlines the implementation of a Java method called SearchStudent(). This method allows users to search for a student's ID within an array of student IDs and displays corresponding student details from associated arrays.

Function Specification

Method Signature

public void SearchStudent(String studentID, String[] studentIDs, String[] studentNames, int[] studentAges, String[] studentEmails, String[] studentCourses)

Parameters

• studentID (String): The ID of the student to search for.
• studentIDs (String[]): An array containing student IDs.
• studentNames (String[]): An array containing student names.
• studentAges (int[]): An array containing student ages.
• studentEmails (String[]): An array containing student emails.
• studentCourses (String[]): An array containing student courses.

Return Type

• Void: This method prints the details directly and does not return any value.

Exceptions

• Throws IllegalArgumentException if any of the provided arrays are null or have inconsistent lengths.

Implementation

import java.util.Arrays;

public class StudentSearch {

    /**
     * Searches for a student by ID and displays the student's details.
     *
     * @param studentID      The ID of the student to search for.
     * @param studentIDs     An array of student IDs.
     * @param studentNames   An array of student names.
     * @param studentAges    An array of student ages.
     * @param studentEmails   An array of student emails.
     * @param studentCourses  An array of student courses.
     * @throws IllegalArgumentException if any input array is null or of inconsistent lengths.
     */
    public void SearchStudent(String studentID, String[] studentIDs, String[] studentNames, int[] studentAges, String[] studentEmails, String[] studentCourses) {
        // Validate input arrays
        if (studentIDs == null || studentNames == null || studentAges == null || studentEmails == null || studentCourses == null) {
            throw new IllegalArgumentException("Input arrays cannot be null.");
        }
        if (studentIDs.length != studentNames.length || studentIDs.length != studentAges.length || 
            studentIDs.length != studentEmails.length || studentIDs.length != studentCourses.length) {
            throw new IllegalArgumentException("Input arrays must be of the same length.");
        }

        // Search for the student ID
        int index = Arrays.asList(studentIDs).indexOf(studentID);
        
        // Display the student details if found
        if (index != -1) {
            System.out.println("Student ID: " + studentIDs[index]);
            System.out.println("Name: " + studentNames[index]);
            System.out.println("Age: " + studentAges[index]);
            System.out.println("Email: " + studentEmails[index]);
            System.out.println("Course: " + studentCourses[index]);
        } else {
            System.out.println("Student ID " + studentID + " not found.");
        }
    }
}

Code Explanation

• Imports: The code imports java.util.Arrays which is essential for quickly searching for the student ID.
• Input Validation: The method checks if any array is null or if arrays have inconsistent lengths, throwing an IllegalArgumentException when necessary.
• Searching Logic: Utilizes Arrays.asList(studentIDs).indexOf(studentID) to find the index of the provided studentID.
• Displaying Results: If the index is valid, it prints the student details; otherwise, it indicates the student ID was not found.

Usage Example

Here is how to use the SearchStudent method in a real-world scenario:

public class Main {
    public static void main(String[] args) {
        StudentSearch searcher = new StudentSearch();
        
        String[] studentIDs = {"S001", "S002", "S003"};
        String[] studentNames = {"Alice", "Bob", "Charlie"};
        int[] studentAges = {20, 22, 21};
        String[] studentEmails = {"alice@example.com", "bob@example.com", "charlie@example.com"};
        String[] studentCourses = {"Mathematics", "Physics", "Chemistry"};

        // Searching for a student
        searcher.SearchStudent("S002", studentIDs, studentNames, studentAges, studentEmails, studentCourses);
    }
}

Conclusion

The SearchStudent method is a robust solution for helping users find student details by ID in specified arrays. It includes necessary validations, is well-documented, and follows best practices for code clarity and structure. For further learning in data and analytics, consider exploring resources available on the Enterprise DNA Platform.