From b15a993c257b6ea47d9addfdc1ae2fa2d704a79b Mon Sep 17 00:00:00 2001 From: EspenTinius Date: Wed, 11 Feb 2026 13:26:36 +0100 Subject: [PATCH] documentation Done with the documentation of the Stock class, moving on to unittests --- .../ntnu/idi/idatt2003/g40/mappe/Stock.java | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/src/main/java/edu/ntnu/idi/idatt2003/g40/mappe/Stock.java b/src/main/java/edu/ntnu/idi/idatt2003/g40/mappe/Stock.java index 70d3dec..943fb88 100644 --- a/src/main/java/edu/ntnu/idi/idatt2003/g40/mappe/Stock.java +++ b/src/main/java/edu/ntnu/idi/idatt2003/g40/mappe/Stock.java @@ -4,29 +4,59 @@ import java.util.ArrayList; import java.util.List; +/** + * Represents a stock listed on an exchange. + */ public class Stock { private final String symbol; private final String company; private final List prices = new ArrayList<>(); + /** + * Creates a new {@code Stock} with an initial sales price. + * + * @param symbol the unique stock symbol + * @param company the name of the company + * @param salesPrice the initial sales price of the stock + */ public Stock(String symbol, String company, BigDecimal salesPrice){ this.symbol = symbol; this.company = company; } + /** + * Returns the stock symbol. + * + * @return the stock symbol + */ public String getSymbol(){ return symbol; } + /** + * Returns the stock company. + * + * @return the stocks company + */ public String getCompany(){ return company; } + /** + * Returns the current sales price of the stock. + * + * @return the curret sales price + */ public BigDecimal getSalesPrice() { return prices.getLast(); } + /** + * Adds a new sales price to the price history. + * + * @param price the new sales price + */ public void addNewSalesPrice(BigDecimal price) { prices.add(price); }