MODELLKLASSER OCH KONTRAKT
Klassdiagram: guide
Skapa klasser visuellt. Definiera medlemmar och relationer, granska modellkontroller, ordna paket och spara eller exportera diagrammet.
Designa klasser och deras ansvarsområden
Klassdiagram är en separat visuell arbetsyta för klasser, abstrakta klasser, gränssnitt och uppräkningar. Varje klassificerare har ett namn, ett attribut- eller litteralfack och ett operationsfack. Abstrakta namn är kursiverade; gränssnitt och uppräkningar visar sin stereotyp. Välj en klass och använd Rubrikfärg för att välja en förinställning, en anpassad färg eller Neutral. Rubrikfärger sparas, stöder Ångra/Gör om och visas i bildexporter; medlemstext förblir läsbar.
Nya diagram ber dig välja Blankt diagram eller mallen Ordersystem. Nya diagram förblir i minnet tills de sparas i molnet eller laddas ner som JSON. Dess kompakta editorfält innehåller diagramnamnet, Arkiv-menyn, Ångra/Gör om, temakontroll och export av bild. Klassdiagram-molnfiler är separata från SQL-, Prisma- och ERD-byggare-dokument.
Bygg ditt första klassdiagram
- Öppna Klassdiagram och välj Tomt diagram eller mallen Ordersystem. Arkiv → Nytt diagram öppnar väljaren igen; Arkiv → Tomt ersätter det nuvarande diagrammet med bekräftelse och Ångra.
- Klicka på Klass eller dra den från biblioteket till arbetsytan, döp sedan om den till Customer i inspektören (använd Redigera detaljer på en smal skärm) och lägg till ett id-attribut med synlighet Privat (-) och typ UUID.
- För en anpassad klassificerare, välj Anpassad klassificerare eller redigera det valfria Stereotyp-fältet på vilken befintlig klassificerare som helst. Taggar som entity, service eller controller visas som «din tagg» ovanför namnet och inkluderas i molnfiler, JSON- och bildexporter. De behåller det valda basklassificerarbeteendet; verktyget validerar inte UML-profiler.
- Lägg till en annan klass med namnet Order. Lägg till en operation såsom calculateTotal med returtypen Decimal. Guidade fält visar en förhandsgranskning innan du bekräftar.
- Välj Association från relationsbiblioteket. Från börjar med den valda klassen när en är vald. Ställ in Från till Kund och Till till Order, skapa sedan den. Välj kopplingen för att lägga till en etikett och multipliciteter.
- För att skapa båda objekten tillsammans, välj en klass och välj Anslut ny. Lägg till ansluten klass låter dig välja den nya klassificeraren, valfritt namn, relation och riktning. Arv och realisering pekar initialt det nya barnet eller implementeraren mot den valda föräldern eller kontraktet; andra typer pekar initialt från den valda klassen till den nya. Skapa ansluten klass sparar båda i ett ångra-steg; Avbryt eller Escape kastar bort formuläret.
- Använd Arrangera och Anpassa diagram, ladda sedan ner JSON från Arkiv för en redigerbar säkerhetskopia eller Exportera diagram för PNG, JPEG, WebP, vektor-SVG eller PDF.
Attribut, literaler och synlighet
Välj en klassificerare och använd Fields för att lägga till ett attribut med ett namn, obligatorisk typ, synlighet och valfritt standardvärde. Typsförslag inkluderar vanliga typer och klassificerarnamn; anpassade typer är tillåtna. Add eller Save changes genomför förhandsgranskningen i en redigering. Cancel eller Escape kasserar det väntande formuläret.
Använd + för publik, - för privat, # för skyddad och ~ för paketsynlighet. Textläge accepterar en medlem per rad. Formatet städar endast stödda giltiga signaturer; anpassad notation förblir text och bevaras när en annan rad ändras.
Uppräkningar använder literaler istället för attribut. Ange ett literalnamn och ett valfritt värde, till exempel ACTIVE = "active". Guidade fält avvisar upprepade medlemsnamn. Anpassad text bevaras även när den inte kan representeras i fält.
- id: UUID
+ displayName: String
# active: Boolean = true
~ tags: List<String> = []Operationer och typade parametrar
En operation har synlighet, ett namn, typade parametrar med valfria standardvärden och en valfri returtyp. Lägg till parameter infogar en inmatningsrad; dess ta bort-knapp raderar den väntande parametern. Nya operationer har som standard returtypen void.
I textläge, skriv namn(parameter: Typ): Returtyp, med ett valfritt synlighetsprefix. Nästlade generiska typer och citerade standardvärden stöds. Varje parameter behöver ett distinkt namn och en typ. Överlagringar kan dela ett operationsnamn när deras parametertyper skiljer sig åt.
+ placeOrder(items: List<OrderItem>): Order
+ findOrders(status: String = "open"): List<Order>
- calculateTotal(): DecimalVälj relationsnotation
Hovra eller fokusera med tangentbordet på en klass (tryck för att välja på pekskärmar) för att avslöja dess anslutningspunkter, dra sedan till en annan klass för en association. Punkter förblir dolda vid vila och i skrivskyddade diagram. Du kan också välja en relation från biblioteket. Inspektören låter dig ändra typ, slutpunkter, etikett och slutpunktsmultiplicitet såsom 1, 0..1 eller 0..*. Multiplicitet är redigerbar text; verktyget härleder inte affärsregler.
Varje multiplicitet har förinställningarna 1, 0..1, 0..* och 1..*. Anpassad text förblir redigerbar och bevaras. Relationsbetydelse förklarar den faktiska riktningen, förälder/kontrakt eller helhet/del, samt associationsantal: Till multiplicitetsantal till instanser per Från; Från multiplicitetsantal räknar det omvända. Vägledning lägger inte till semantisk validering.
Relationsnamn placeras direkt på kopplingen nära dess mittpunkt. Multiplicitet stannar nära sin egen klassgräns och rensar UML-huvudena. Etiketter följer med vid dragning och lägger sig sedan mot andra etiketter när de släpps. Lång text radbryts; trånga rutter kan behöva en tydlig reservlösning om etiketten inte får plats på linjen.
Roller och navigering lägger till valfri Från-roll och Till-roll bredvid den relevanta klassen. Olika roller eller etiketter särskiljer parallella strukturella länkar, såsom faktureringsadress och leveransadress. Associationsnavigering kan peka på Från, Till eller båda. Andra relationstyper behåller sina semantiska huvuden.
Verktyget avvisar saknade slutpunkter, exakta dubbletter av samma riktning/typ/etikett/strukturell roll, arvscykler och självarv eller realisering. Multiplicitet, navigering och sökvägsändringar ensamma skapar inte en distinkt länk. Association, aggregering, komposition och beroende kan koppla en klass till sig själv. Dessa strukturella kontroller fastställer inte fullständig UML-semantisk giltighet.
| Relation | Riktning och symbol |
|---|---|
| Association | Linje mellan associerade klassificerare; valfria navigeringspilar pekar på en nåbar klass. Rekursiva länkar stöds. |
| Arv | Från är underklassen. En heldragen linje slutar i en ihålig triangel vid Till, föräldern. |
| Realisering | Från implementerar kontraktet vid Till. En streckad linje slutar i en ihålig triangel vid Till. |
| Aggregering | Från är helheten och Till är delen. En ihålig romb tillhör Från. |
| Komposition | Från äger livslängden för Till. En fylld romb tillhör Från. |
| Beroende | Från beror på Till. En streckad öppen pil pekar mot leverantören vid Till. |
Automatiska sidor, fasta huvuden och sökvägar
Böjd är standard för ett nytt diagram. Visa → Anslutningsvägar i arbetsytans verktygsfält erbjuder Böjd och Armbåge för att ställa in alla vägar och standarden för nya anslutningar. Armbåge använder horisontella och vertikala segment med små rundade hörn. Välj en anslutning för att åsidosätta dess linjeväg individuellt.
Nya anslutningar väljer lämpliga sidor automatiskt när klasser flyttas eller ändrar storlek. Vänster- och högeranslutningar fäster vid rubriken. Topp och botten fäster vid motsvarande kortgräns. Att välja Topp, Botten, Vänster eller Höger i inspektorn fixerar endast den slutpunkten; dess partner kan fortsätta följa med automatiskt.
Välj Auto i väljaren för från- eller till-sida så följer den änden klassen. Automatiska sidor frigör båda ändarna. Dra en markerad ände för att byta sida eller mittpunkten för att böja kopplingen. Escape avbryter; Home eller dubbelklick återställer böjen. Återställ koppling återställer automatisk linjedragning. Justeringar stöder Ångra, sparande och bildexport.
Sökvägar undviker sina anslutna kort; rekursiva länkar loopar utanför klassen, och parallella länkar använder separata rutter. Arrangemang och automatiska sidor förbättrar läsbarheten men garanterar inte undvikande av varje obesläktat kort eller annan anslutning. Äldre JSON-utkast utan sidlägen bevarar sina sparade sidor tills du väljer Auto.
Kontrollera din modell och döp om säkert
Kontroller öppnar Fel, Varningar och Förslag för medlemsnotation, namn, multiplicitetsgränser och arvstruktur. Välj ett problem för att visa dess klass eller relation och det relevanta fältet. Kontroller bevarar anpassad text, utför aldrig automatisk korrigering och fungerar inte som en kompilator för programmeringsspråk.
Byt namn med referenser... i en vald klass förhandsgranskar exakta typ-referenser i attribut, operationsparametrar och returtyper. Välj referenserna som ska uppdateras och tillämpa sedan namnet och referenserna som ett ångra-steg. Anpassad notation, standardvärden, kvalificerade externa typer och tvetydiga referenser till upprepade klassificerarnamn förblir oförändrade.
Valda typers ersättningar måste rymmas inom gränsen på 8 000 tecken för varje medlemsfack. Om en föreslagen uppdatering skulle överskrida denna, avmarkera vissa referenser eller rensa alla referensval för att endast byta namn på klassen. Verktyget avvisar den för stora uppdateringen istället för att trunkera medlemstexten.
Justera, distribuera och lås klasser
Layout erbjuder justering av valda klasser, lika horisontella/vertikala mellanrum, Arrangera urval, positionslås och en växel för Fäst vid stödlinjer. Ctrl/Cmd-klicka för att välja klasser. Låsta klasser förblir fixerade under dragning, paketflytt och arrangemang; lås överlever sparande. Lika mellanrum bevarar yttre klasser och lämnar trånga spann oförändrade. Urvalsarrangemang lämnar andra klasser fixerade och placerar dess block fritt från dem, eller håller grafen intakt om ingen placering passar. Dragning av enstaka klasser fäster inom sex skärmpixlar; stödlinjer och deras växel stannar utanför sparade filer.
Ordna och navigera på arbetsytan
Klicka på Ordna för smart arrangemang. Den använder klassstorlekar och relationsstruktur, placerar föräldrar och gränssnitt ovanför barn och separerar frånkopplade grupper. Rullgardinsmenyn erbjuder även Vänster till höger, Topp till botten och Kompakt.
Arrangemang bevarar relationsbetydelse och fasta ändpunktsidor, uppdaterar automatiska sidor och anpassar resultatet. Ångra återställer det i ett steg. Om dokumentet ändras medan layoutmotorn laddas, kastas det inaktuella resultatet; ordna igen för det nya dokumentet.
Stora layouter flyttas tillsammans inom sparade positionsgränser. Om en arrangemang inte får plats förblir ditt diagram intakt; prova Endast namn eller en annan riktning, och arrangera sedan igen.
Dra klasser för att positionera dem, dra i den tomma arbetsytan för att panorera, och scrolla för att zooma. Anpassa diagram och zoom-kontrollerna hjälper till att navigera; minikartan visar en översikt. Vid bredder upp till 900px flyttas inspektören under arbetsytan. Välj en klass eller anslutning och välj Redigera detaljer (Visa detaljer för en delad fil) för att nå den; Tillbaka till diagram återgår till arbetsytan. Att välja en relation öppnar dess formulär i vyn. Guiden för klassdiagram öppnas i en separat flik så att det aktuella utkastet förblir öppet.
Hitta eller Ctrl/Cmd+K söker efter namn, stereotyper, attribut, operationer, paketnamn och anteckningar. Använd Pil upp/ner och Enter för att välja och centrera ett resultat; medlemsresultat avslöjar klassens fullständiga detaljer och fokuserar dess matchande inspektörssektion. Escape stänger Hitta. Fokusera kopplingar betonar den valda klassen och omedelbara grannar medan obesläktade element dämpas; Visa alla eller Escape avslutar fokus.
Öppna Vy i arbetsytans verktygsfält för att välja Fullständiga detaljer, Endast attribut eller Endast namn. Endast attribut behåller attribut eller uppräkningsliteraler och sammanfattar operationer; Endast namn visar medlemsantal. Håll muspekaren över, fokusera eller välj en klass för att åsidosätta dess detaljnivå, eller välj Diagramstandard för att ärva. Att ändra den globala nivån rensar åsidosättningar. Fokus och detaljer fungerar även i delade filer, stannar utanför sparade dokument och Ångra/Gör om, och ändrar inte medlemstext. Bilder följer den valda detaljnivån; JSON- och molnfiler behåller fullständiga medlemmar.
Håll Ctrl/Cmd nedtryckt medan du klickar för att välja en grupp. Det kompakta markeringsverktygsfältet visar Fokus, Duplicera och Anslut ny när det är tillämpligt; Fler markeringsåtgärder innehåller Kopiera markering, Skapa paket och Ta bort markering. Mobil Redigera detaljer eller Visa detaljer öppnar fortfarande inspektören. Duplicera markering skapar en förskjuten kopia; Kopiera markering och Klistra in kan överföra klasser eller anteckningar mellan klassdiagram när webbläsarens urklippsåtkomst är tillgänglig. En kopia i minnet stöder Klistra in inom arbetsytan. Kopior får nya ID:n och oanvända namn, bevarar gruppförskjutningar och interna relationer, och inkluderar endast ett paket när alla dess klasser kopieras. Att välja ett paket kopierar alla dess medlemmar. En duplicering eller inklistring är ett ångra-steg; textfält behåller inbyggt beteende för kopiera/klistra in.
Lägg till anteckningar och gruppera klasser i paket
Anteckning — Lägg till en kommentar skapar en anteckning och fokuserar anteckningstexten i inspektören; en tom anteckning på arbetsytan säger Skriv en anteckning…. Fäst anteckning länkar den till en klass eller relation med en streckad linje; anteckningen stannar där den placerades medan linjen följer målet. Att ta bort målet lossar anteckningen och behåller dess text. Långa anteckningar radbryts till en begränsad förhandsgranskning; fullständig text förblir redigerbar.
Paket — Gruppklasser grupperar valda klasser omedelbart. Om inget är valt, välj medlemmar och ett valfritt paketnamn, välj sedan Skapa paket. Varje klass tillhör högst ett paket. Dra dess rubrik för att flytta medlemmarna tillsammans såvida inte en medlem är positionslåst. Avgruppera klasser tar endast bort ramen. Använd rubrikens chevron eller inspektör för att kollapsa ett paket till ett klassantal med externa anslutningar. Hitta och kontroller expanderar paket för att avslöja medlemmar. Paket förblir visuella grupper, inte namnrymder eller semantiska relationsändpunkter. Kollaps är endast för visning: JSON/moln behåller alla medlemmar och länkar; bilder matchar den visade vyn.
Molnfiler, portabel JSON och bilder
Arkiv → Exportera PlantUML förhandsgranskar redigerbar källkod och erbjuder Kopiera text eller Ladda ner .puml. Den exporterar fullständiga medlemmar, typer, stereotyper, färger, roller/navigering/multiplicitet, paket och anteckningar lokalt. PlantUML väljer sin egen layout, så canvaspositioner, fasta sidor, positionslås och kollapsade vyer exporteras inte. Använd JSON för att bevara det kompletta redigerbara diagrammet. PlantUML-import är inte tillgänglig.
Klassdiagram sparar inte diagram i webbläsarens lagring. Nya diagram förblir i minnet. Spara (Ctrl/Cmd+S) loggar in vid behov och skapar eller uppdaterar en oberoende molnfil för klassdiagram. Arkiv → Öppna klassdiagram öppnar en egen sökbar fillista. Arkiv → Dela klassdiagram kontrollerar allmän åtkomst; tittare kan inspektera och exportera men kan inte redigera. Osparade diagram efterfrågar bekräftelse innan du lämnar eller laddar om sidan. Ladda ner JSON från Arkiv för att behålla en redigerbar kopia, och använd Importera JSON för att öppna en exporterad version 1 Erd Go-klassdiagramfil igen. Importer valideras före ersättning.
Blank, Exempel och Importera frågar innan ett icke-tomt diagram ersätts och stöder Ångra. Exportera diagram erbjuder PNG, JPEG, WebP, fristående vektor-SVG och bildbaserad PDF på vit bakgrund. Fånga hela diagrammet (standard), inklusive klasser utanför skärmen, eller den aktuella vyn. HD-, 2K- och 4K-förinställningar bevarar proportioner inom 8192px per sida och 16 megapixlar; vektor-SVG skalar fritt. Behåll JSON eller en molnfil för vidare redigering av diagrammet.
Valfria anteckningar och paket utökar det befintliga formatet i version 1; äldre filer öppnas fortfarande utan dem. Gränserna är 200 klassificerare, 600 relationer, 100 anteckningar på upp till 2 000 tecken, 50 paket, 8 000 tecken per medlemsfack och en importerad JSON-fil på 32 MB. Molnfilnamn måste innehålla 3–255 tecken. Spara i molnet eller ladda ner JSON innan du lämnar sidan för att behålla ett osparat diagram. Gamla webbläsarlokala utkast lämnas oförändrade och öppnas inte längre automatiskt.
Kortkommandon
| Åtgärd | Genväg |
|---|---|
| Spara till molnet | Ctrl/Cmd+S. Logga in om du blir ombedd. |
| Hitta en klass, medlem, paket eller anteckning | Ctrl/Cmd+K, sedan Pil Upp/Ner och Enter. |
| Kopiera / Klistra in markering | Ctrl/Cmd+C / Ctrl/Cmd+V från arbetsytan. Klistra in kräver ett redigerbart diagram. |
| Duplicera markering | Ctrl/Cmd+D från arbetsytan. |
| Ångra / Gör om | Ctrl/Cmd+Z / Ctrl/Cmd+Shift+Z eller Ctrl/Cmd+Y från arbetsytan. |
| Ta bort markering | Ta bort eller använd Backsteg från arbetsytan. Att ta bort en klass tar även bort dess tillhörande relationer. |
| Välj kopplingssida | Fokusera ett valt kopplingshuvud och använd en piltangent. |
| Avbryt eller stäng | Escape avbryter en medlem, ansluten klass eller paketformulär eller förhandsgranskning av anslutningshuvud, stänger Sök eller en meny, eller avslutar Fokus-anslutningar från arbetsytan. |
Felsök ditt diagram
| Symptom | Vad som ska testas |
|---|---|
| Ett huvud stannar på en oväntad sida | Kontrollera om den änden är Fixerad. Välj dess Auto-kontroll för att återuppta automatisk placering. |
| En relation avvisas | Kontrollera slutpunkter, exakta dubbletter, själv-arv/realisering och arvscykler. Ge distinkta strukturella länkar olika roller eller etiketter. |
| En medlem kan inte sparas | Ange obligatoriska namn/typer, ta bort dubbla parameternamn eller medlemssignaturer och granska valideringsmeddelandet. Använd Text för notation som inte stöds. |
| Ett formulär säger att medlemmar ändrades | Avbryt och öppna den igen efter Ångra eller en annan textredigering för att använda den aktuella medlemsversionen. |
| En klass eller medlem är utom synhåll | Använd Hitta eller Ctrl/Cmd+K. Medlemsresultat visar fullständiga detaljer och fokuserar på den matchande inspektörssektionen; Anpassa diagram och minikartan hjälper också till. |
| En fil kan inte importeras | Välj en exporterad Erd Go-klassdiagram-JSON-fil, inte SQL, en byggarfil, SVG eller en modelleringsplan. Ditt nuvarande diagram behålls vid fel. |
| Molnsparning misslyckades | Håll diagrammet öppet, kontrollera din inloggning och anslutning, och försök sedan igen. Ladda ner JSON innan du lämnar sidan för att behålla en redigerbar säkerhetskopia. |
Planera en klassmodell med AI
Använd Copy AI Prompt för att dela denna guide med din assistent, beskriv sedan ansvarsområden, ägarskap, arv och multipliciteter. Be om förtydligande där kraven gör en relation tvetydig.
Begär klassificerarnamn, medlemssignaturer och en relationslista med explicita Från- och Till-roller. Bygg resultatet med hjälp av det visuella biblioteket och inspektören. Följande plan är beskrivande, inte ett importspråk.
Class Customer
Attribute: - id: UUID
Operation: + placeOrder(items: List<OrderItem>): Order
Class Order
Operation: + calculateTotal(): Decimal
Association: Customer → Order
Label: places
Customer end: 1
Order end: 0..*